PxeBaseCodeCallBack.h File Reference

Go to the source code of this file.

Data Structures
struct	_EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL

Macros
#define	EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_GUID
#define	EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION   0x00010000
#define	EFI_PXE_BASE_CODE_CALLBACK_INTERFACE_REVISION    EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION

Typedefs
typedef struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL	EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL
typedef EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL	EFI_PXE_BASE_CODE_CALLBACK
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)

Enumerations
enum	EFI_PXE_BASE_CODE_FUNCTION {   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 }
enum	EFI_PXE_BASE_CODE_CALLBACK_STATUS { 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 }

Variables
EFI_GUID	gEfiPxeBaseCodeCallbackProtocolGuid

Detailed Description

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 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Revision Reference:

This Protocol is introduced in EFI Specification 1.10

Definition in file PxeBaseCodeCallBack.h.

Macro Definition Documentation

EFI_PXE_BASE_CODE_CALLBACK_INTERFACE_REVISION

#define EFI_PXE_BASE_CODE_CALLBACK_INTERFACE_REVISION    EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION

EFI 1.1 Revision Number defintion.

Definition at line 32 of file PxeBaseCodeCallBack.h.

EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_GUID

#define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_GUID

Value:

  { \
    0x245dca21, 0xfb7b, 0x11d3, {0x8f, 0x01, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \
  }

Call Back Definitions.

Definition at line 19 of file PxeBaseCodeCallBack.h.

EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION

#define EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL_REVISION   0x00010000

UEFI Revision Number Definition.

Definition at line 27 of file PxeBaseCodeCallBack.h.

Typedef Documentation

EFI_PXE_BASE_CODE_CALLBACK

typedef EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK

EFI1.1 Protocol name.

Definition at line 43 of file PxeBaseCodeCallBack.h.

EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL

typedef struct _EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL

UEFI Protocol name.

Definition at line 38 of file PxeBaseCodeCallBack.h.

EFI_PXE_CALLBACK

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)

Callback function that is invoked when the PXE Base Code Protocol is about to transmit, has received, or is waiting to receive a packet.

This function is invoked when the PXE Base Code Protocol is about to transmit, has received, or is waiting to receive a packet. Parameters Function and Received specify the type of event. Parameters PacketLen and Packet specify the packet that generated the event. If these fields are zero and NULL respectively, then this is a status update callback. If the operation specified by Function is to continue, then CALLBACK_STATUS_CONTINUE should be returned. If the operation specified by Function should be aborted, then CALLBACK_STATUS_ABORT should be returned. Due to the polling nature of UEFI device drivers, a callback function should not execute for more than 5 ms. The SetParameters() function must be called after a Callback Protocol is installed to enable the use of callbacks.

Parameters

This	The pointer to the EFI_PXE_BASE_CODE_CALLBACK_PROTOCOL instance.
Function	The PXE Base Code Protocol function that is waiting for an event.
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.
PacketLen	The length, in bytes, of Packet. This field will have a value of zero if this is a wait for receive event.
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.

Return values

EFI_PXE_BASE_CODE_CALLBACK_STATUS_CONTINUE	if Function specifies a continue operation
EFI_PXE_BASE_CODE_CALLBACK_STATUS_ABORT	if Function specifies an abort operation

Definition at line 98 of file PxeBaseCodeCallBack.h.

Enumeration Type Documentation

EFI_PXE_BASE_CODE_CALLBACK_STATUS

enum EFI_PXE_BASE_CODE_CALLBACK_STATUS

Callback status type.

Definition at line 63 of file PxeBaseCodeCallBack.h.

EFI_PXE_BASE_CODE_FUNCTION

enum EFI_PXE_BASE_CODE_FUNCTION

Event type list for PXE Base Code Protocol function.

Definition at line 48 of file PxeBaseCodeCallBack.h.