mirror of https://github.com/acidanthera/audk.git
115 lines
4.6 KiB
C
115 lines
4.6 KiB
C
/** @file
|
|
EFI PXE Base Code CallBack Protocol is as defined in UEFI specification.
|
|
It is invoked when the PXE Base Code Protocol is about to transmit, has received,
|
|
or is waiting to receive a packet.
|
|
|
|
Copyright (c) 2006 - 2008, Intel Corporation
|
|
All rights reserved. This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#ifndef _PXE_BASE_CODE_CALLBACK_H_
|
|
#define _PXE_BASE_CODE_CALLBACK_H_
|
|
|
|
//
|
|
// Call Back Definitions
|
|
//
|
|
#define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_GUID \
|
|
{ \
|
|
0x245dca21, 0xfb7b, 0x11d3, {0x8f, 0x01, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \
|
|
}
|
|
|
|
//
|
|
// Revision Number
|
|
//
|
|
#define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION 0x00010000
|
|
#define EFI_PXE_BASE_CODE_CALLBACK_INTERFACE_REVISION \
|
|
EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION
|
|
|
|
//
|
|
// Protocol definition
|
|
//
|
|
typedef struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL;
|
|
|
|
//
|
|
// Protocol defined in EFI1.1.
|
|
//
|
|
typedef EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK;
|
|
|
|
typedef enum {
|
|
EFI_PXE_BASE_CODE_FUNCTION_FIRST,
|
|
EFI_PXE_BASE_CODE_FUNCTION_DHCP,
|
|
EFI_PXE_BASE_CODE_FUNCTION_DISCOVER,
|
|
EFI_PXE_BASE_CODE_FUNCTION_MTFTP,
|
|
EFI_PXE_BASE_CODE_FUNCTION_UDP_WRITE,
|
|
EFI_PXE_BASE_CODE_FUNCTION_UDP_READ,
|
|
EFI_PXE_BASE_CODE_FUNCTION_ARP,
|
|
EFI_PXE_BASE_CODE_FUNCTION_IGMP,
|
|
EFI_PXE_BASE_CODE_PXE_FUNCTION_LAST
|
|
} EFI_PXE_BASE_CODE_FUNCTION;
|
|
|
|
typedef enum {
|
|
EFI_PXE_BASE_CODE_CALLBACK_STATUS_FIRST,
|
|
EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE,
|
|
EFI_PXE_BASE_CODE_CALLBACK_STATUS_ABORT,
|
|
EFI_PXE_BASE_CODE_CALLBACK_STATUS_LAST
|
|
} EFI_PXE_BASE_CODE_CALLBACK_STATUS;
|
|
|
|
/**
|
|
Callback function that is invoked when the PXE Base Code Protocol is about to transmit, has
|
|
received, or is waiting to receive a packet.
|
|
|
|
@param This Pointer to the EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL instance.
|
|
@param Function The PXE Base Code Protocol function that is waiting for an event.
|
|
@param Received TRUE if the callback is being invoked due to a receive event. FALSE if
|
|
the callback is being invoked due to a transmit event.
|
|
@param PacketLen The length, in bytes, of Packet. This field will have a value of zero if
|
|
this is a wait for receive event.
|
|
@param Packet If Received is TRUE, a pointer to the packet that was just received;
|
|
otherwise a pointer to the packet that is about to be transmitted.
|
|
|
|
@retval EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE if Function specifies a continue operation
|
|
@retval EFI_PXE_BASE_CODE_CALLBACK_STATUS_ABORT if Function specifies an abort operation
|
|
|
|
**/
|
|
typedef
|
|
EFI_PXE_BASE_CODE_CALLBACK_STATUS
|
|
(EFIAPI *EFI_PXE_CALLBACK)(
|
|
IN EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL *This,
|
|
IN EFI_PXE_BASE_CODE_FUNCTION Function,
|
|
IN BOOLEAN Received,
|
|
IN UINT32 PacketLen,
|
|
IN EFI_PXE_BASE_CODE_PACKET *Packet OPTIONAL
|
|
);
|
|
|
|
/**
|
|
@par Protocol Description:
|
|
Protocol that is invoked when the PXE Base Code Protocol is about
|
|
to transmit, has received, or is waiting to receive a packet.
|
|
|
|
@param Revision
|
|
The revision of the EFI_PXE_BASE_CODE_PROTOCOL. All future revisions must
|
|
be backwards compatible. If a future version is not backwards compatible
|
|
it is not the same GUID.
|
|
|
|
@param Callback
|
|
Callback routine used by the PXE Base Code Dhcp(), Discover(), Mtftp(),
|
|
UdpWrite(), and Arp() functions.
|
|
|
|
**/
|
|
struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL {
|
|
UINT64 Revision;
|
|
EFI_PXE_CALLBACK Callback;
|
|
};
|
|
|
|
extern EFI_GUID gEfiPxeBaseCodeCallbackProtocolGuid;
|
|
|
|
#endif
|
|
|