X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=MdePkg%2FInclude%2FProtocol%2FManagedNetwork.h;h=52c9f08bb1103aa587987e5646b26408d4095141;hb=c3afcf3a36d0aa9433ded54bae82fa26a4e4bceb;hp=45ff98270ba1f924bf910098f3398dcd76c3198d;hpb=19bee90c32772dd225332193858d9c2fcd2930aa;p=mirror_edk2.git diff --git a/MdePkg/Include/Protocol/ManagedNetwork.h b/MdePkg/Include/Protocol/ManagedNetwork.h index 45ff98270b..52c9f08bb1 100644 --- a/MdePkg/Include/Protocol/ManagedNetwork.h +++ b/MdePkg/Include/Protocol/ManagedNetwork.h @@ -2,14 +2,17 @@ EFI_MANAGED_NETWORK_SERVICE_BINDING_PROTOCOL as defined in UEFI 2.0. EFI_MANAGED_NETWORK_PROTOCOL as defined in UEFI 2.0. - Copyright (c) 2006, 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. +Copyright (c) 2006 - 2010, 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 that 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. + + @par Revision Reference: + This Protocol is introduced in UEFI Specification 2.0 **/ @@ -31,15 +34,58 @@ typedef struct _EFI_MANAGED_NETWORK_PROTOCOL EFI_MANAGED_NETWORK_PROTOCOL; typedef struct { + /// + /// Timeout value for a UEFI one-shot timer event. A packet that has not been removed + /// from the MNP receive queue will be dropped if its receive timeout expires. + /// UINT32 ReceivedQueueTimeoutValue; + /// + /// Timeout value for a UEFI one-shot timer event. A packet that has not been removed + /// from the MNP transmit queue will be dropped if its receive timeout expires. + /// UINT32 TransmitQueueTimeoutValue; + /// + /// Ethernet type II 16-bit protocol type in host byte order. Valid + /// values are zero and 1,500 to 65,535. + /// UINT16 ProtocolTypeFilter; + /// + /// Set to TRUE to receive packets that are sent to the network + /// device MAC address. The startup default value is FALSE. + /// BOOLEAN EnableUnicastReceive; + /// + /// Set to TRUE to receive packets that are sent to any of the + /// active multicast groups. The startup default value is FALSE. + /// BOOLEAN EnableMulticastReceive; + /// + /// Set to TRUE to receive packets that are sent to the network + /// device broadcast address. The startup default value is FALSE. + /// BOOLEAN EnableBroadcastReceive; + /// + /// Set to TRUE to receive packets that are sent to any MAC address. + /// The startup default value is FALSE. + /// BOOLEAN EnablePromiscuousReceive; + /// + /// Set to TRUE to drop queued packets when the configuration + /// is changed. The startup default value is FALSE. + /// BOOLEAN FlushQueuesOnReset; + /// + /// Set to TRUE to timestamp all packets when they are received + /// by the MNP. Note that timestamps may be unsupported in some + /// MNP implementations. The startup default value is FALSE. + /// BOOLEAN EnableReceiveTimestamps; + /// + /// Set to TRUE to disable background polling in this MNP + /// instance. Note that background polling may not be supported in + /// all MNP implementations. The startup default value is FALSE, + /// unless background polling is not supported. + /// BOOLEAN DisableBackgroundPolling; } EFI_MANAGED_NETWORK_CONFIG_DATA; @@ -77,10 +123,26 @@ typedef struct { typedef struct { + /// + /// This Event will be signaled after the Status field is updated + /// by the MNP. The type of Event must be + /// EFI_NOTIFY_SIGNAL. The Task Priority Level (TPL) of + /// Event must be lower than or equal to TPL_CALLBACK. + /// EFI_EVENT Event; + /// + /// The status that is returned to the caller at the end of the operation + /// to indicate whether this operation completed successfully. + /// EFI_STATUS Status; union { + /// + /// When this token is used for receiving, RxData is a pointer to the EFI_MANAGED_NETWORK_RECEIVE_DATA. + /// EFI_MANAGED_NETWORK_RECEIVE_DATA *RxData; + /// + /// When this token is used for transmitting, TxData is a pointer to the EFI_MANAGED_NETWORK_TRANSMIT_DATA. + /// EFI_MANAGED_NETWORK_TRANSMIT_DATA *TxData; } Packet; } EFI_MANAGED_NETWORK_COMPLETION_TOKEN; @@ -88,9 +150,9 @@ typedef struct { /** Returns the operational parameters for the current MNP child driver. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. - @param MnpConfigData Pointer to storage for MNP operational parameters. - @param SnpModeData Pointer to storage for SNP operational parameters. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param MnpConfigData The pointer to storage for MNP operational parameters. + @param SnpModeData The pointer to storage for SNP operational parameters. @retval EFI_SUCCESS The operation completed successfully. @retval EFI_INVALID_PARAMETER This is NULL. @@ -106,14 +168,13 @@ EFI_STATUS IN EFI_MANAGED_NETWORK_PROTOCOL *This, OUT EFI_MANAGED_NETWORK_CONFIG_DATA *MnpConfigData OPTIONAL, OUT EFI_SIMPLE_NETWORK_MODE *SnpModeData OPTIONAL - ) -; + ); /** Sets or clears the operational parameters for the MNP child driver. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. - @param MnpConfigData Pointer to configuration data that will be assigned to the MNP + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param MnpConfigData The pointer to configuration data that will be assigned to the MNP child driver instance. If NULL, the MNP child driver instance is reset to startup defaults and all pending transmit and receive requests are flushed. @@ -133,17 +194,16 @@ EFI_STATUS (EFIAPI *EFI_MANAGED_NETWORK_CONFIGURE)( IN EFI_MANAGED_NETWORK_PROTOCOL *This, IN EFI_MANAGED_NETWORK_CONFIG_DATA *MnpConfigData OPTIONAL - ) -; + ); /** Translates an IP multicast address to a hardware (MAC) multicast address. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. @param Ipv6Flag Set to TRUE to if IpAddress is an IPv6 multicast address. Set to FALSE if IpAddress is an IPv4 multicast address. - @param IpAddress Pointer to the multicast IP address (in network byte order) to convert. - @param MacAddress Pointer to the resulting multicast MAC address. + @param IpAddress The pointer to the multicast IP address (in network byte order) to convert. + @param MacAddress The pointer to the resulting multicast MAC address. @retval EFI_SUCCESS The operation completed successfully. @retval EFI_INVALID_PARAMETER One of the following conditions is TRUE: @@ -164,16 +224,15 @@ EFI_STATUS IN BOOLEAN Ipv6Flag, IN EFI_IP_ADDRESS *IpAddress, OUT EFI_MAC_ADDRESS *MacAddress - ) -; + ); /** Enables and disables receive filters for multicast address. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. @param JoinFlag Set to TRUE to join this multicast group. Set to FALSE to leave this multicast group. - @param MacAddress Pointer to the multicast MAC group (address) to join or leave. + @param MacAddress The pointer to the multicast MAC group (address) to join or leave. @retval EFI_SUCCESS The requested operation completed successfully. @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE: @@ -194,14 +253,13 @@ EFI_STATUS IN EFI_MANAGED_NETWORK_PROTOCOL *This, IN BOOLEAN JoinFlag, IN EFI_MAC_ADDRESS *MacAddress OPTIONAL - ) -; + ); /** Places asynchronous outgoing data packets into the transmit queue. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. - @param Token Pointer to a token associated with the transmit data descriptor. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param Token The pointer to a token associated with the transmit data descriptor. @retval EFI_SUCCESS The transmit completion token was cached. @retval EFI_NOT_STARTED This MNP child driver instance has not been configured. @@ -218,21 +276,20 @@ EFI_STATUS (EFIAPI *EFI_MANAGED_NETWORK_TRANSMIT)( IN EFI_MANAGED_NETWORK_PROTOCOL *This, IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token - ) -; + ); /** Places an asynchronous receiving request into the receiving queue. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. - @param Token Pointer to a token associated with the receive data descriptor. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param Token The pointer to a token associated with the receive data descriptor. @retval EFI_SUCCESS The receive completion token was cached. @retval EFI_NOT_STARTED This MNP child driver instance has not been configured. @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE: - This is NULL. - Token is NULL. - - Token.Event is NULL + - Token.Event is NULL. @retval EFI_OUT_OF_RESOURCES The transmit data could not be queued due to a lack of system resources (usually memory). @retval EFI_DEVICE_ERROR An unexpected system or network error occurred. @@ -245,15 +302,14 @@ EFI_STATUS (EFIAPI *EFI_MANAGED_NETWORK_RECEIVE)( IN EFI_MANAGED_NETWORK_PROTOCOL *This, IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token - ) -; + ); /** Aborts an asynchronous transmit or receive request. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. - @param Token Pointer to a token that has been issued by + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param Token The pointer to a token that has been issued by EFI_MANAGED_NETWORK_PROTOCOL.Transmit() or EFI_MANAGED_NETWORK_PROTOCOL.Receive(). If NULL, all pending tokens are aborted. @@ -273,13 +329,12 @@ EFI_STATUS (EFIAPI *EFI_MANAGED_NETWORK_CANCEL)( IN EFI_MANAGED_NETWORK_PROTOCOL *This, IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token OPTIONAL - ) -; + ); /** Polls for incoming data packets and processes outgoing data packets. - @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. + @param This The pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. @retval EFI_SUCCESS Incoming or outgoing data was processed. @retval EFI_NOT_STARTED This MNP child driver instance has not been configured. @@ -294,9 +349,12 @@ typedef EFI_STATUS (EFIAPI *EFI_MANAGED_NETWORK_POLL)( IN EFI_MANAGED_NETWORK_PROTOCOL *This - ) -; + ); +/// +/// The MNP is used by network applications (and drivers) to +/// perform raw (unformatted) asynchronous network packet I/O. +/// struct _EFI_MANAGED_NETWORK_PROTOCOL { EFI_MANAGED_NETWORK_GET_MODE_DATA GetModeData; EFI_MANAGED_NETWORK_CONFIGURE Configure;