MdePkg[all]  1.08
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
HttpBootCallback.h File Reference

Data Structures

struct  _EFI_HTTP_BOOT_CALLBACK_PROTOCOL
 

Macros

#define EFI_HTTP_BOOT_CALLBACK_PROTOCOL_GUID
 

Typedefs

typedef struct
_EFI_HTTP_BOOT_CALLBACK_PROTOCOL 
EFI_HTTP_BOOT_CALLBACK_PROTOCOL
 
typedef IN
EFI_HTTP_BOOT_CALLBACK_DATA_TYPE 
DataType
 
typedef IN
EFI_HTTP_BOOT_CALLBACK_DATA_TYPE
IN BOOLEAN 
Received
 
typedef IN
EFI_HTTP_BOOT_CALLBACK_DATA_TYPE
IN BOOLEAN IN UINT32 
DataLength
 
typedef IN
EFI_HTTP_BOOT_CALLBACK_DATA_TYPE
IN BOOLEAN IN UINT32 IN VOID
Data
 

Enumerations

enum  EFI_HTTP_BOOT_CALLBACK_DATA_TYPE {
  HttpBootDhcp4, HttpBootDhcp6, HttpBootHttpRequest, HttpBootHttpResponse,
  HttpBootHttpEntityBody, HttpBootTypeMax
}
 

Functions

typedef EFI_STATUS (EFIAPI *EFI_HTTP_BOOT_CALLBACK)(IN EFI_HTTP_BOOT_CALLBACK_PROTOCOL *This
 

Variables

EFI_GUID gEfiHttpBootCallbackProtocolGuid
 

Detailed Description

This file defines the EFI HTTP Boot Callback Protocol interface.

Copyright (c) 2017 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Revision Reference:
This Protocol is introduced in UEFI Specification 2.7

Macro Definition Documentation

#define EFI_HTTP_BOOT_CALLBACK_PROTOCOL_GUID
Value:
{ \
0xba23b311, 0x343d, 0x11e6, {0x91, 0x85, 0x58, 0x20, 0xb1, 0xd6, 0x52, 0x99} \
}

Typedef Documentation

typedef IN UINTN DataLength

Enumeration Type Documentation

EFI_HTTP_BOOT_CALLBACK_DATA_TYPE

Enumerator
HttpBootDhcp4 

Data points to a DHCP4 packet which is about to transmit or has received.

HttpBootDhcp6 

Data points to a DHCP6 packet which is about to be transmit or has received.

HttpBootHttpRequest 

Data points to an EFI_HTTP_MESSAGE structure, whichcontians a HTTP request message to be transmitted.

HttpBootHttpResponse 

Data points to an EFI_HTTP_MESSAGE structure, which contians a received HTTP response message.

HttpBootHttpEntityBody 

Part of the entity body has been received from the HTTP server. Data points to the buffer of the entity body data.

HttpBootTypeMax 

Function Documentation

typedef EFI_STATUS ( EFIAPI EFI_HTTP_BOOT_CALLBACK)

Callback function that is invoked when the HTTP Boot driver is about to transmit or has received a packet.

This function is invoked when the HTTP Boot driver is about to transmit or has received packet. Parameters DataType and Received specify the type of event and the format of the buffer pointed to by Data. Due to the polling nature of UEFI device drivers, this callback function should not execute for more than 5 ms. The returned status code determines the behavior of the HTTP Boot driver.

Parameters
[in]ThisPointer to the EFI_HTTP_BOOT_CALLBACK_PROTOCOL instance.
[in]DataTypeThe event that occurs in the current state.
[in]ReceivedTRUE if the callback is being invoked due to a receive event. FALSE if the callback is being invoked due to a transmit event.
[in]DataLengthThe length in bytes of the buffer pointed to by Data.
[in]DataA pointer to the buffer of data, the data type is specified by DataType.
Return values
EFI_SUCCESSTells the HTTP Boot driver to continue the HTTP Boot process.
EFI_ABORTEDTells the HTTP Boot driver to abort the current HTTP Boot process.

Variable Documentation

EFI_GUID gEfiHttpBootCallbackProtocolGuid