2 EFI PXE Base Code CallBack Protocol
4 Copyright (c) 2006, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
13 Module Name: PxeBaseCodeCallBack.h
17 #ifndef _PXE_BASE_CODE_CALLBACK_H_
18 #define _PXE_BASE_CODE_CALLBACK_H_
21 // Call Back Definitions
23 #define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_GUID \
25 0x245dca21, 0xfb7b, 0x11d3, {0x8f, 0x01, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \
31 #define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION 0x00010000
32 #define EFI_PXE_BASE_CODE_CALLBACK_INTERFACE_REVISION \
33 EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION
36 // Protocol definition
38 typedef struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL
;
41 // Protocol defined in EFI1.1.
43 typedef EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK
;
46 EFI_PXE_BASE_CODE_FUNCTION_FIRST
,
47 EFI_PXE_BASE_CODE_FUNCTION_DHCP
,
48 EFI_PXE_BASE_CODE_FUNCTION_DISCOVER
,
49 EFI_PXE_BASE_CODE_FUNCTION_MTFTP
,
50 EFI_PXE_BASE_CODE_FUNCTION_UDP_WRITE
,
51 EFI_PXE_BASE_CODE_FUNCTION_UDP_READ
,
52 EFI_PXE_BASE_CODE_FUNCTION_ARP
,
53 EFI_PXE_BASE_CODE_FUNCTION_IGMP
,
54 EFI_PXE_BASE_CODE_PXE_FUNCTION_LAST
55 } EFI_PXE_BASE_CODE_FUNCTION
;
58 EFI_PXE_BASE_CODE_CALLBACK_STATUS_FIRST
,
59 EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE
,
60 EFI_PXE_BASE_CODE_CALLBACK_STATUS_ABORT
,
61 EFI_PXE_BASE_CODE_CALLBACK_STATUS_LAST
62 } EFI_PXE_BASE_CODE_CALLBACK_STATUS
;
65 Callback function that is invoked when the PXE Base Code Protocol is about to transmit, has
66 received, or is waiting to receive a packet.
68 @param This Pointer to the EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL instance.
69 @param Function The PXE Base Code Protocol function that is waiting for an event.
70 @param Received TRUE if the callback is being invoked due to a receive event. FALSE if
71 the callback is being invoked due to a transmit event.
72 @param PacketLen The length, in bytes, of Packet. This field will have a value of zero if
73 this is a wait for receive event.
74 @param Packet If Received is TRUE, a pointer to the packet that was just received;
75 otherwise a pointer to the packet that is about to be transmitted.
77 @retval EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE if Function specifies a continue operation
78 @retval EFI_PXE_BASE_CODE_CALLBACK_STATUS_ABORT if Function specifies an abort operation
82 EFI_PXE_BASE_CODE_CALLBACK_STATUS
83 (EFIAPI
*EFI_PXE_CALLBACK
)(
84 IN EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL
*This
,
85 IN EFI_PXE_BASE_CODE_FUNCTION Function
,
88 IN EFI_PXE_BASE_CODE_PACKET
*Packet OPTIONAL
91 struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL
{
93 EFI_PXE_CALLBACK Callback
;
96 extern EFI_GUID gEfiPxeBaseCodeCallbackProtocolGuid
;