MdePkg/Include/Protocol/Ip4Config2.h File Reference


Data Structures

struct  EFI_IP4_CONFIG2_INTERFACE_INFO
struct  EFI_IP4_CONFIG2_MANUAL_ADDRESS
struct  _EFI_IP4_CONFIG2_PROTOCOL

Defines

#define EFI_IP4_CONFIG2_PROTOCOL_GUID

Typedefs

typedef struct
_EFI_IP4_CONFIG2_PROTOCOL 
EFI_IP4_CONFIG2_PROTOCOL
typedef IN
EFI_IP4_CONFIG2_DATA_TYPE 
DataType
typedef IN
EFI_IP4_CONFIG2_DATA_TYPE IN
UINTN 
DataSize
typedef IN
EFI_IP4_CONFIG2_DATA_TYPE IN
UINTN IN VOID * 
Data
typedef IN
EFI_IP4_CONFIG2_DATA_TYPE IN
EFI_EVENT 
Event

Enumerations

enum  EFI_IP4_CONFIG2_DATA_TYPE {
  Ip4Config2DataTypeInterfaceInfo, Ip4Config2DataTypePolicy, Ip4Config2DataTypeManualAddress, Ip4Config2DataTypeGateway,
  Ip4Config2DataTypeDnsServer, Ip4Config2DataTypeMaximum
}
enum  EFI_IP4_CONFIG2_POLICY { Ip4Config2PolicyStatic, Ip4Config2PolicyDhcp, Ip4Config2PolicyMax }

Functions

typedef EFI_STATUS (EFIAPI *EFI_IP4_CONFIG2_SET_DATA)(IN EFI_IP4_CONFIG2_PROTOCOL *This

Variables

EFI_GUID gEfiIp4Config2ProtocolGuid

Detailed Description

This file provides a definition of the EFI IPv4 Configuration II Protocol.

Copyright (c) 2015, 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.

Revision Reference:
This Protocol is introduced in UEFI Specification 2.5

Define Documentation

#define EFI_IP4_CONFIG2_PROTOCOL_GUID

Value:

{ \
    0x5b446ed1, 0xe30b, 0x4faa, {0x87, 0x1a, 0x36, 0x54, 0xec, 0xa3, 0x60, 0x80 } \
  }


Typedef Documentation

typedef IN EFI_IP4_CONFIG2_DATA_TYPE IN OUT UINTN IN VOID* Data

typedef IN EFI_IP4_CONFIG2_DATA_TYPE IN OUT UINTN* DataSize


Enumeration Type Documentation

EFI_IP4_CONFIG2_DATA_TYPE

Enumerator:
Ip4Config2DataTypeInterfaceInfo  The interface information of the communication device this EFI IPv4 Configuration II Protocol instance manages. This type of data is read only. The corresponding Data is of type EFI_IP4_CONFIG2_INTERFACE_INFO.
Ip4Config2DataTypePolicy  The general configuration policy for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol instance manages. The policy will affect other configuration settings. The corresponding Data is of type EFI_IP4_CONFIG2_POLICY.
Ip4Config2DataTypeManualAddress  The station addresses set manually for the EFI IPv4 network stack. It is only configurable when the policy is Ip4Config2PolicyStatic. The corresponding Data is of type EFI_IP4_CONFIG2_MANUAL_ADDRESS.
Ip4Config2DataTypeGateway  The gateway addresses set manually for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol manages. It is not configurable when the policy is Ip4Config2PolicyDhcp. The gateway addresses must be unicast IPv4 addresses. The corresponding Data is a pointer to an array of EFI_IPv4_ADDRESS instances.
Ip4Config2DataTypeDnsServer  The DNS server list for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol manages. It is not configurable when the policy is Ip4Config2PolicyDhcp. The DNS server addresses must be unicast IPv4 addresses. The corresponding Data is a pointer to an array of EFI_IPv4_ADDRESS instances.
Ip4Config2DataTypeMaximum 

EFI_IP4_CONFIG2_POLICY

Enumerator:
Ip4Config2PolicyStatic  Under this policy, the Ip4Config2DataTypeManualAddress, Ip4Config2DataTypeGateway and Ip4Config2DataTypeDnsServer configuration data are required to be set manually. The EFI IPv4 Protocol will get all required configuration such as IPv4 address, subnet mask and gateway settings from the EFI IPv4 Configuration II protocol.
Ip4Config2PolicyDhcp  Under this policy, the Ip4Config2DataTypeManualAddress, Ip4Config2DataTypeGateway and Ip4Config2DataTypeDnsServer configuration data are not allowed to set via SetData(). All of these configurations are retrieved from DHCP server or other auto-configuration mechanism.
Ip4Config2PolicyMax 


Function Documentation

typedef EFI_STATUS ( EFIAPI *  EFI_IP4_CONFIG2_UNREGISTER_NOTIFY  ) 

Set the configuration for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol instance manages.

This function is used to set the configuration data of type DataType for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol instance manages. The successfully configured data is valid after system reset or power-off. The DataSize is used to calculate the count of structure instances in the Data for some DataType that multiple structure instances are allowed. This function is always non-blocking. When setting some typeof configuration data, an asynchronous process is invoked to check the correctness of the data, such as doing address conflict detection on the manually set local IPv4 address. EFI_NOT_READY is returned immediately to indicate that such an asynchronous process is invoked and the process is not finished yet. The caller willing to get the result of the asynchronous process is required to call RegisterDataNotify() to register an event on the specified configuration data. Once the event is signaled, the caller can call GetData()to get back the configuration data in order to know the result. For other types of configuration data that do not require an asynchronous configuration process, the result of the operation is immediately returned.

Parameters:
[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
[in] DataType The type of data to set.
[in] DataSize Size of the buffer pointed to by Data in bytes.
[in] Data The data buffer to set. The type ofthe data buffer is associated with the DataType.
Return values:
EFI_SUCCESS The specified configuration data for the EFI IPv4 network stack is set successfully.
EFI_INVALID_PARAMETER One or more of the following are TRUE: This is NULL. Data is NULL. One or more fields in Data do not match the requirement of the data type indicated by DataType.
EFI_WRITE_PROTECTED The specified configuration data is read-only or the specified configuration data can not be set under the current policy.
EFI_ACCESS_DENIED Another set operation on the specified configuration data is already in process.
EFI_NOT_READY An asynchronous process is invoked to set the specified configuration data and the process is not finished yet.
EFI_BAD_BUFFER_SIZE The DataSize does not match the size of the type indicated by DataType.
EFI_UNSUPPORTED This DataType is not supported.
EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
EFI_DEVICE_ERROR An unexpected system error or network error occurred.
Get the configuration data for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol instance manages.

This function returns the configuration data of type DataType for the EFI IPv4 network stack running on the communication device this EFI IPv4 Configuration II Protocol instance manages. The caller is responsible for allocating the buffer usedto return the specified configuration data and the required size will be returned to the caller if the size of the buffer is too small. EFI_NOT_READY is returned if the specified configuration data is not ready due to an already in progress asynchronous configuration process. The caller can call RegisterDataNotify() to register an event on the specified configuration data. Once the asynchronous configuration process is finished, the event will be signaled and a subsequent GetData() call will return the specified configuration data.

Parameters:
[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
[in] DataType The type of data to get.
[out] DataSize On input, in bytes, the size of Data. On output, in bytes, the size of buffer required to store the specified configuration data.
[in] Data The data buffer in which the configuration data is returned. The type of the data buffer is associated with the DataType. Ignored if DataSize is 0.
Return values:
EFI_SUCCESS The specified configuration data is got successfully.
EFI_INVALID_PARAMETER One or more of the followings are TRUE: This is NULL. DataSize is NULL. Data is NULL if *DataSizeis not zero.
EFI_BUFFER_TOO_SMALL The size of Data is too small for the specified configuration data and the required size is returned in DataSize.
EFI_NOT_READY The specified configuration data is not ready due to an already in progress asynchronous configuration process.
EFI_NOT_FOUND The specified configuration data is not found.
Register an event that is to be signaled whenever a configuration process on the specified configuration data is done.

This function registers an event that is to be signaled whenever a configuration process on the specified configuration data is done. An event can be registered for different DataType simultaneously and the caller is responsible for determining which type of configuration data causes the signaling of the event in such case.

Parameters:
[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
[in] DataType The type of data to unregister the event for.
[in] Event The event to register.
Return values:
EFI_SUCCESS The notification event for the specified configuration data is registered.
EFI_INVALID_PARAMETER This is NULL or Event is NULL.
EFI_UNSUPPORTED The configuration data type specified by DataType is not supported.
EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
EFI_ACCESS_DENIED The Event is already registered for the DataType.
Remove a previously registered event for the specified configuration data.

This function removes a previously registeredevent for the specified configuration data.

Parameters:
[in] This Pointer to the EFI_IP4_CONFIG2_PROTOCOL instance.
[in] DataType The type of data to remove the previously registered event for.
[in] Event The event to unregister.
Return values:
EFI_SUCCESS The event registered for the specified configuration data is removed.
EFI_INVALID_PARAMETER This is NULL or Event is NULL.
EFI_NOT_FOUND The Eventhas not been registered for the specified DataType.


Variable Documentation


Generated on Wed Sep 23 16:24:23 2015 for MdePkg[ALL] by  doxygen 1.5.7.1