| /** @file | |
| Copyright (c) 2005 - 2008, 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. | |
| Module Name: | |
| MnpImpl.h | |
| Abstract: | |
| **/ | |
| #ifndef _MNP_IMPL_H_ | |
| #define _MNP_IMPL_H_ | |
| #include "MnpDriver.h" | |
| #define NET_ETHER_FCS_SIZE 4 | |
| #define MNP_SYS_POLL_INTERVAL (10 * TICKS_PER_MS) // 10 milliseconds | |
| #define MNP_TIMEOUT_CHECK_INTERVAL (10 * TICKS_PER_MS) // 10 milliseconds | |
| #define MNP_TX_TIMEOUT_TIME (500 * TICKS_PER_MS) // 500 milliseconds | |
| #define MNP_INIT_NET_BUFFER_NUM 512 | |
| #define MNP_NET_BUFFER_INCREASEMENT 64 | |
| #define MNP_MAX_NET_BUFFER_NUM 65536 | |
| #define MNP_MAX_RCVD_PACKET_QUE_SIZE 256 | |
| #define MNP_RECEIVE_UNICAST 0x01 | |
| #define MNP_RECEIVE_BROADCAST 0x02 | |
| #define UNICAST_PACKET MNP_RECEIVE_UNICAST | |
| #define BROADCAST_PACKET MNP_RECEIVE_BROADCAST | |
| #define MNP_INSTANCE_DATA_SIGNATURE SIGNATURE_32 ('M', 'n', 'p', 'I') | |
| #define MNP_INSTANCE_DATA_FROM_THIS(a) \ | |
| CR ( \ | |
| (a), \ | |
| MNP_INSTANCE_DATA, \ | |
| ManagedNetwork, \ | |
| MNP_INSTANCE_DATA_SIGNATURE \ | |
| ) | |
| typedef struct _MNP_INSTANCE_DATA { | |
| UINT32 Signature; | |
| MNP_SERVICE_DATA *MnpServiceData; | |
| EFI_HANDLE Handle; | |
| LIST_ENTRY InstEntry; | |
| EFI_MANAGED_NETWORK_PROTOCOL ManagedNetwork; | |
| BOOLEAN Configured; | |
| BOOLEAN Destroyed; | |
| LIST_ENTRY GroupCtrlBlkList; | |
| NET_MAP RxTokenMap; | |
| LIST_ENTRY RxDeliveredPacketQueue; | |
| LIST_ENTRY RcvdPacketQueue; | |
| UINTN RcvdPacketQueueSize; | |
| EFI_MANAGED_NETWORK_CONFIG_DATA ConfigData; | |
| UINT8 ReceiveFilter; | |
| } MNP_INSTANCE_DATA; | |
| typedef struct _MNP_GROUP_ADDRESS { | |
| LIST_ENTRY AddrEntry; | |
| EFI_MAC_ADDRESS Address; | |
| INTN RefCnt; | |
| } MNP_GROUP_ADDRESS; | |
| typedef struct _MNP_GROUP_CONTROL_BLOCK { | |
| LIST_ENTRY CtrlBlkEntry; | |
| MNP_GROUP_ADDRESS *GroupAddress; | |
| } MNP_GROUP_CONTROL_BLOCK; | |
| typedef struct _MNP_RXDATA_WRAP { | |
| LIST_ENTRY WrapEntry; | |
| MNP_INSTANCE_DATA *Instance; | |
| EFI_MANAGED_NETWORK_RECEIVE_DATA RxData; | |
| NET_BUF *Nbuf; | |
| UINT64 TimeoutTick; | |
| } MNP_RXDATA_WRAP; | |
| /** | |
| Initialize the mnp service context data. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param ImageHandle The driver image handle. | |
| @param ControllerHandle Handle of device to bind driver to. | |
| @retval EFI_SUCCESS The mnp service context is initialized. | |
| @retval Other Some error occurs. | |
| **/ | |
| EFI_STATUS | |
| MnpInitializeServiceData ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN EFI_HANDLE ImageHandle, | |
| IN EFI_HANDLE ControllerHandle | |
| ); | |
| /** | |
| Flush the mnp service context data. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param ImageHandle The driver image handle. | |
| **/ | |
| VOID | |
| MnpFlushServiceData ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN EFI_HANDLE ImageHandle | |
| ); | |
| /** | |
| Initialize the mnp instance context data. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param Instance Pointer to the mnp instance context data to | |
| initialize. | |
| **/ | |
| VOID | |
| MnpInitializeInstanceData ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN MNP_INSTANCE_DATA *Instance | |
| ); | |
| /** | |
| Check whether the token specified by Arg maches the token in Item. | |
| @param Map Pointer to the NET_MAP. | |
| @param Item Pointer to the NET_MAP_ITEM | |
| @param Arg Pointer to the Arg, it's a pointer to the token to | |
| check. | |
| @retval EFI_SUCCESS The token specified by Arg is different from the | |
| token in Item. | |
| @retval EFI_ACCESS_DENIED The token specified by Arg is the same as that in | |
| Item. | |
| **/ | |
| EFI_STATUS | |
| MnpTokenExist ( | |
| IN NET_MAP *Map, | |
| IN NET_MAP_ITEM *Item, | |
| IN VOID *Arg | |
| ); | |
| /** | |
| Cancel the token specified by Arg if it matches the token in Item. | |
| @param Map Pointer to the NET_MAP. | |
| @param Item Pointer to the NET_MAP_ITEM | |
| @param Arg Pointer to the Arg, it's a pointer to the token to | |
| cancel. | |
| @retval EFI_SUCCESS The Arg is NULL, and the token in Item is | |
| cancelled, or the Arg isn't NULL, and the token in | |
| Item is different from the Arg. | |
| @retval EFI_ABORTED The Arg isn't NULL, the token in Item mathces the | |
| Arg, and the token is cancelled. | |
| **/ | |
| EFI_STATUS | |
| MnpCancelTokens ( | |
| IN NET_MAP *Map, | |
| IN NET_MAP_ITEM *Item, | |
| IN VOID *Arg | |
| ); | |
| /** | |
| Flush the instance's received data. | |
| @param Instance Pointer to the mnp instance context data. | |
| **/ | |
| VOID | |
| MnpFlushRcvdDataQueue ( | |
| IN MNP_INSTANCE_DATA *Instance | |
| ); | |
| /** | |
| Configure the Instance using ConfigData. | |
| @param Instance Pointer to the mnp instance context data. | |
| @param ConfigData Pointer to the configuration data used to configure | |
| the isntance. | |
| @retval EFI_SUCCESS The Instance is configured. | |
| @retval EFI_UNSUPPORTED EnableReceiveTimestamps is on and the | |
| implementation doesn't support it. | |
| @retval Other Some error occurs. | |
| **/ | |
| EFI_STATUS | |
| MnpConfigureInstance ( | |
| IN MNP_INSTANCE_DATA *Instance, | |
| IN EFI_MANAGED_NETWORK_CONFIG_DATA *ConfigData OPTIONAL | |
| ); | |
| /** | |
| Do the group operations for this instance. | |
| @param Instance Pointer to the instance context data. | |
| @param JoinFlag Set to TRUE to join a group. Set to TRUE to leave a | |
| group/groups. | |
| @param MacAddress Pointer to the group address to join or leave. | |
| @param CtrlBlk Pointer to the group control block if JoinFlag if | |
| FALSE. | |
| @retval EFI_SUCCESS The group operation finished. | |
| @retval Other Some error occurs. | |
| **/ | |
| EFI_STATUS | |
| MnpGroupOp ( | |
| IN MNP_INSTANCE_DATA *Instance, | |
| IN BOOLEAN JoinFlag, | |
| IN EFI_MAC_ADDRESS *MacAddr OPTIONAL, | |
| IN MNP_GROUP_CONTROL_BLOCK *CtrlBlk OPTIONAL | |
| ); | |
| /** | |
| Validates the Mnp transmit token. | |
| @param Instance Pointer to the Mnp instance context data. | |
| @param Token Pointer to the transmit token to check. | |
| @return The Token is valid or not. | |
| **/ | |
| BOOLEAN | |
| MnpIsValidTxToken ( | |
| IN MNP_INSTANCE_DATA *Instance, | |
| IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token | |
| ); | |
| /** | |
| Build the packet to transmit from the TxData passed in. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param TxData Pointer to the transmit data containing the | |
| information to build the packet. | |
| @param PktBuf Pointer to record the address of the packet. | |
| @param PktLen Pointer to a UINT32 variable used to record the | |
| packet's length. | |
| **/ | |
| VOID | |
| MnpBuildTxPacket ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN EFI_MANAGED_NETWORK_TRANSMIT_DATA *TxData, | |
| OUT UINT8 **PktBuf, | |
| OUT UINT32 *PktLen | |
| ); | |
| /** | |
| Synchronously send out the packet. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param Packet Pointer to the pakcet buffer. | |
| @param Length The length of the packet. | |
| @param Token Pointer to the token the packet generated from. | |
| @retval EFI_SUCCESS The packet is sent out. | |
| @retval EFI_TIMEOUT Time out occurs, the packet isn't sent. | |
| @retval EFI_DEVICE_ERROR An unexpected network error occurs. | |
| **/ | |
| EFI_STATUS | |
| MnpSyncSendPacket ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN UINT8 *Packet, | |
| IN UINT32 Length, | |
| IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token | |
| ); | |
| /** | |
| Try to deliver the received packet to the instance. | |
| @param Instance Pointer to the mnp instance context data. | |
| @retval EFI_SUCCESS The received packet is delivered, or there is no | |
| packet to deliver, or there is no available receive | |
| token. | |
| @retval EFI_OUT_OF_RESOURCES The deliver fails due to lack of memory resource. | |
| **/ | |
| EFI_STATUS | |
| MnpInstanceDeliverPacket ( | |
| IN MNP_INSTANCE_DATA *Instance | |
| ); | |
| /** | |
| Recycle the RxData and other resources used to hold and deliver the received | |
| packet. | |
| @param Event The event this notify function registered to. | |
| @param Context Pointer to the context data registerd to the Event. | |
| **/ | |
| VOID | |
| EFIAPI | |
| MnpRecycleRxData ( | |
| IN EFI_EVENT Event, | |
| IN VOID *Context | |
| ); | |
| /** | |
| Try to receive a packet and deliver it. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @retval EFI_SUCCESS add return value to function comment | |
| @retval EFI_NOT_STARTED The simple network protocol is not started. | |
| @retval EFI_NOT_READY No packet received. | |
| @retval EFI_DEVICE_ERROR An unexpected error occurs. | |
| **/ | |
| EFI_STATUS | |
| MnpReceivePacket ( | |
| IN MNP_SERVICE_DATA *MnpServiceData | |
| ); | |
| /** | |
| Allocate a free NET_BUF from MnpServiceData->FreeNbufQue. If there is none | |
| in the queue, first try to allocate some and add them into the queue, then | |
| fetch the NET_BUF from the updated FreeNbufQue. | |
| @param MnpServiceData Pointer to the MNP_SERVICE_DATA. | |
| @return Pointer to the allocated free NET_BUF structure, if NULL the operation is failed. | |
| **/ | |
| NET_BUF * | |
| MnpAllocNbuf ( | |
| IN MNP_SERVICE_DATA *MnpServiceData | |
| ); | |
| /** | |
| Try to reclaim the Nbuf into the buffer pool. | |
| @param MnpServiceData Pointer to the mnp service context data. | |
| @param Nbuf Pointer to the NET_BUF to free. | |
| **/ | |
| VOID | |
| MnpFreeNbuf ( | |
| IN MNP_SERVICE_DATA *MnpServiceData, | |
| IN NET_BUF *Nbuf | |
| ); | |
| /** | |
| Remove the received packets if timeout occurs. | |
| @param Event The event this notify function registered to. | |
| @param Context Pointer to the context data registered to the | |
| event. | |
| **/ | |
| VOID | |
| EFIAPI | |
| MnpCheckPacketTimeout ( | |
| IN EFI_EVENT Event, | |
| IN VOID *Context | |
| ); | |
| /** | |
| Poll to receive the packets from Snp. This function is either called by upperlayer | |
| protocols/applications or the system poll timer notify mechanism. | |
| @param Event The event this notify function registered to. | |
| @param Context Pointer to the context data registered to the | |
| event. | |
| **/ | |
| VOID | |
| EFIAPI | |
| MnpSystemPoll ( | |
| IN EFI_EVENT Event, | |
| IN VOID *Context | |
| ); | |
| /** | |
| Returns the operational parameters for the current MNP child driver. May also | |
| support returning the underlying SNP driver mode data. | |
| The GetModeData() function is used to read the current mode data (operational | |
| parameters) from the MNP or the underlying SNP. | |
| @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. | |
| @param MnpConfigData Pointer to storage for MNP operational parameters. Type | |
| EFI_MANAGED_NETWORK_CONFIG_DATA is defined in "Related | |
| Definitions" below. | |
| @param SnpModeData Pointer to storage for SNP operational parameters. This | |
| feature may be unsupported. Type EFI_SIMPLE_NETWORK_MODE | |
| is defined in the EFI_SIMPLE_NETWORK_PROTOCOL. | |
| @retval EFI_SUCCESS The operation completed successfully. | |
| @retval EFI_INVALID_PARAMETER This is NULL. | |
| @retval EFI_UNSUPPORTED The requested feature is unsupported in this | |
| MNP implementation. | |
| @retval EFI_NOT_STARTED This MNP child driver instance has not been | |
| configured. The default values are returned in | |
| MnpConfigData if it is not NULL. | |
| @retval Other The mode data could not be read. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpGetModeData ( | |
| 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. | |
| The Configure() function is used to set, change, or reset the operational | |
| parameters for the MNP child driver instance. Until the operational parameters | |
| have been set, no network traffic can be sent or received by this MNP child | |
| driver instance. Once the operational parameters have been reset, no more | |
| traffic can be sent or received until the operational parameters have been set | |
| again. | |
| Each MNP child driver instance can be started and stopped independently of | |
| each other by setting or resetting their receive filter settings with the | |
| Configure() function. | |
| After any successful call to Configure(), the MNP child driver instance is | |
| started. The internal periodic timer (if supported) is enabled. Data can be | |
| transmitted and may be received if the receive filters have also been enabled. | |
| Note: If multiple MNP child driver instances will receive the same packet | |
| because of overlapping receive filter settings, then the first MNP child | |
| driver instance will receive the original packet and additional instances will | |
| receive copies of the original packet. | |
| Note: Warning: Receive filter settings that overlap will consume extra | |
| processor and/or DMA resources and degrade system and network performance. | |
| @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. | |
| @param MnpConfigData 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. Type EFI_MANAGED_NETWORK_CONFIG_DATA is | |
| defined in | |
| EFI_MANAGED_NETWORK_PROTOCOL.GetModeData(). | |
| @retval EFI_SUCCESS The operation completed successfully. | |
| @retval EFI_INVALID_PARAMETER One or more of the following conditions is | |
| TRUE: | |
| * This is NULL. | |
| * MnpConfigData.ProtocolTypeFilter is not | |
| valid. | |
| The operational data for the MNP child driver | |
| instance is unchanged. | |
| @retval EFI_OUT_OF_RESOURCES Required system resources (usually memory) | |
| could not be allocated. | |
| The MNP child driver instance has been reset to | |
| startup defaults. | |
| @retval EFI_UNSUPPORTED The requested feature is unsupported in | |
| this [MNP] implementation. The operational data | |
| for the MNP child driver instance is unchanged. | |
| @retval EFI_DEVICE_ERROR An unexpected network or system error | |
| occurred. The MNP child driver instance has | |
| been reset to startup defaults. | |
| @retval Other The MNP child driver instance has been reset to | |
| startup defaults. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpConfigure ( | |
| 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. This | |
| function may be unsupported in some MNP implementations. | |
| The McastIpToMac() function translates an IP multicast address to a hardware | |
| (MAC) multicast address. This function may be implemented by calling the | |
| underlying EFI_SIMPLE_NETWORK.MCastIpToMac() function, which may also be | |
| unsupported in some MNP implementations. | |
| @param This 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. | |
| @retval EFI_SUCCESS The operation completed successfully. | |
| @retval EFI_INVALID_PARAMETER One of the following conditions is TRUE: | |
| * This is NULL. | |
| * IpAddress is NULL. | |
| * IpAddress is not a valid multicast IP | |
| address. | |
| * MacAddress is NULL. | |
| @retval EFI_NOT_STARTED This MNP child driver instance has not been | |
| configured. | |
| @retval EFI_UNSUPPORTED The requested feature is unsupported in this | |
| MNP implementation. | |
| @retval EFI_DEVICE_ERROR An unexpected network or system error occurred. | |
| @retval Other The address could not be converted. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpMcastIpToMac ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This, | |
| IN BOOLEAN Ipv6Flag, | |
| IN EFI_IP_ADDRESS *IpAddress, | |
| OUT EFI_MAC_ADDRESS *MacAddress | |
| ); | |
| /** | |
| Enables and disables receive filters for multicast address. This function may | |
| be unsupported in some MNP implementations. | |
| The Groups() function only adds and removes multicast MAC addresses from the | |
| filter list. The MNP driver does not transmit or process Internet Group | |
| Management Protocol (IGMP) packets. If JoinFlag is FALSE and MacAddress is | |
| NULL, then all joined groups are left. | |
| @param This 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. | |
| @retval EFI_SUCCESS The requested operation completed successfully. | |
| @retval EFI_INVALID_PARAMETER One or more of the following conditions is TRUE: | |
| * This is NULL. | |
| * JoinFlag is TRUE and MacAddress is NULL. | |
| * MacAddress is not a valid multicast MAC | |
| address. | |
| * The MNP multicast group settings are | |
| unchanged. | |
| @retval EFI_NOT_STARTED This MNP child driver instance has not been | |
| configured. | |
| @retval EFI_ALREADY_STARTED The supplied multicast group is already joined. | |
| @retval EFI_NOT_FOUND The supplied multicast group is not joined. | |
| @retval EFI_DEVICE_ERROR An unexpected network or system error occurred. | |
| The MNP child driver instance has been reset to | |
| startup defaults. | |
| @retval EFI_UNSUPPORTED The requested feature is unsupported in this MNP | |
| implementation. | |
| @retval Other The requested operation could not be completed. | |
| The MNP multicast group settings are unchanged. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpGroups ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This, | |
| IN BOOLEAN JoinFlag, | |
| IN EFI_MAC_ADDRESS *MacAddress OPTIONAL | |
| ); | |
| /** | |
| Places asynchronous outgoing data packets into the transmit queue. | |
| The Transmit() function places a completion token into the transmit packet | |
| queue. This function is always asynchronous. | |
| The caller must fill in the Token.Event and Token.TxData fields in the | |
| completion token, and these fields cannot be NULL. When the transmit operation | |
| completes, the MNP updates the Token.Status field and the Token.Event is | |
| signaled. | |
| Note: There may be a performance penalty if the packet needs to be | |
| defragmented before it can be transmitted by the network device. Systems in | |
| which performance is critical should review the requirements and features of | |
| the underlying communications device and drivers. | |
| @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. | |
| @param Token Pointer to a token associated with the transmit data | |
| descriptor. Type EFI_MANAGED_NETWORK_COMPLETION_TOKEN is | |
| defined in "Related Definitions" below. | |
| @retval EFI_SUCCESS The transmit 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.TxData is NULL. | |
| * Token.TxData.DestinationAddress is not | |
| NULL and Token.TxData.HeaderLength is zero. | |
| * Token.TxData.FragmentCount is zero. | |
| * (Token.TxData.HeaderLength + | |
| Token.TxData.DataLength) is not equal to the | |
| sum of the | |
| Token.TxData.FragmentTable[].FragmentLength | |
| fields. | |
| * One or more of the | |
| Token.TxData.FragmentTable[].FragmentLength | |
| fields is zero. | |
| * One or more of the | |
| Token.TxData.FragmentTable[].FragmentBufferfields | |
| is NULL. | |
| * Token.TxData.DataLength is greater than MTU. | |
| @retval EFI_ACCESS_DENIED The transmit completion token is already in the | |
| transmit queue. | |
| @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. | |
| The MNP child driver instance has been reset to | |
| startup defaults. | |
| @retval EFI_NOT_READY The transmit request could not be queued because | |
| the transmit queue is full. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpTransmit ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This, | |
| IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token | |
| ); | |
| /** | |
| Aborts an asynchronous transmit or receive request. | |
| The Cancel() function is used to abort a pending transmit or receive request. | |
| If the token is in the transmit or receive request queues, after calling this | |
| function, Token.Status will be set to EFI_ABORTED and then Token.Event will be | |
| signaled. If the token is not in one of the queues, which usually means that | |
| the asynchronous operation has completed, this function will not signal the | |
| token and EFI_NOT_FOUND is returned. | |
| @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. | |
| @param Token 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. | |
| @retval EFI_SUCCESS The asynchronous I/O request was aborted and | |
| Token.Event was signaled. When Token is NULL, | |
| all pending requests were aborted and their | |
| events were signaled. | |
| @retval EFI_NOT_STARTED This MNP child driver instance has not been | |
| configured. | |
| @retval EFI_INVALID_PARAMETER This is NULL. | |
| @retval EFI_NOT_FOUND When Token is not NULL, the asynchronous I/O | |
| request was not found in the transmit or | |
| receive queue. It has either completed or was | |
| not issued by Transmit() and Receive(). | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpCancel ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This, | |
| IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token OPTIONAL | |
| ); | |
| /** | |
| Places an asynchronous receiving request into the receiving queue. | |
| The Receive() function places a completion token into the receive packet | |
| queue. This function is always asynchronous. | |
| The caller must fill in the Token.Event field in the completion token, and | |
| this field cannot be NULL. When the receive operation completes, the MNP | |
| updates the Token.Status and Token.RxData fields and the Token.Event is | |
| signaled. | |
| @param This Pointer to the EFI_MANAGED_NETWORK_PROTOCOL instance. | |
| @param Token Pointer to a token associated with the receive | |
| data descriptor. Type | |
| EFI_MANAGED_NETWORK_COMPLETION_TOKEN is defined in | |
| EFI_MANAGED_NETWORK_PROTOCOL.Transmit(). | |
| @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 | |
| @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. | |
| The MNP child driver instance has been reset to | |
| startup defaults. | |
| @retval EFI_ACCESS_DENIED The receive completion token was already in the | |
| receive queue. | |
| @retval EFI_NOT_READY The receive request could not be queued because | |
| the receive queue is full. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpReceive ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This, | |
| IN EFI_MANAGED_NETWORK_COMPLETION_TOKEN *Token | |
| ); | |
| /** | |
| Polls for incoming data packets and processes outgoing data packets. | |
| The Poll() function can be used by network drivers and applications to | |
| increase the rate that data packets are moved between the communications | |
| device and the transmit and receive queues. | |
| Normally, a periodic timer event internally calls the Poll() function. But, in | |
| some systems, the periodic timer event may not call Poll() fast enough to | |
| transmit and/or receive all data packets without missing packets. Drivers and | |
| applications that are experiencing packet loss should try calling the Poll() | |
| function more often. | |
| @param This 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. | |
| @retval EFI_DEVICE_ERROR An unexpected system or network error occurred. The | |
| MNP child driver instance has been reset to startup | |
| defaults. | |
| @retval EFI_NOT_READY No incoming or outgoing data was processed. Consider | |
| increasing the polling rate. | |
| @retval EFI_TIMEOUT Data was dropped out of the transmit and/or receive | |
| queue. Consider increasing the polling rate. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| MnpPoll ( | |
| IN EFI_MANAGED_NETWORK_PROTOCOL *This | |
| ); | |
| #endif |