Remove #include <Protocol/LoadedImage.h>
Remove //#include <Protocol/Ip4.h> Remove #include <Library/UefiLib.h> Fix one function header description error Fix filer header Fix function header Fix return status issues Fix in out issues Fix no Boolean expression issues git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7096 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
ywu21
@ -1,6 +1,7 @@
|
||||
/** @file
|
||||
|
||||
Copyright (c) 2005 - 2007, Intel Corporation
|
||||
Network library.
|
||||
|
||||
Copyright (c) 2005 - 2007, Intel Corporation.<BR>
|
||||
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
|
||||
@ -8,26 +9,15 @@ 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:
|
||||
|
||||
NetLib.c
|
||||
|
||||
Abstract:
|
||||
|
||||
|
||||
|
||||
**/
|
||||
|
||||
#include <PiDxe.h>
|
||||
#include <Uefi.h>
|
||||
|
||||
#include <Protocol/ServiceBinding.h>
|
||||
#include <Protocol/SimpleNetwork.h>
|
||||
#include <Protocol/LoadedImage.h>
|
||||
#include <Protocol/NicIp4Config.h>
|
||||
#include <Protocol/ComponentName.h>
|
||||
#include <Protocol/ComponentName2.h>
|
||||
#include <Protocol/Ip4.h>
|
||||
#include <Protocol/Dpc.h>
|
||||
|
||||
#include <Library/NetLib.h>
|
||||
@ -36,7 +26,6 @@ Abstract:
|
||||
#include <Library/BaseMemoryLib.h>
|
||||
#include <Library/UefiBootServicesTableLib.h>
|
||||
#include <Library/UefiRuntimeServicesTableLib.h>
|
||||
#include <Library/UefiLib.h>
|
||||
#include <Library/MemoryAllocationLib.h>
|
||||
#include <Library/DevicePathLib.h>
|
||||
|
||||
@ -93,11 +82,10 @@ EFI_IPv4_ADDRESS mZeroIp4Addr = {{0, 0, 0, 0}};
|
||||
return the invalid length 33, which is IP4_MASK_NUM.
|
||||
NetMask is in the host byte order.
|
||||
|
||||
@param NetMask The netmask to get the length from
|
||||
|
||||
@return The length of the netmask, IP4_MASK_NUM if the mask isn't
|
||||
@return supported.
|
||||
@param[in] NetMask The netmask to get the length from.
|
||||
|
||||
@return The length of the netmask, IP4_MASK_NUM if the mask isn't.
|
||||
|
||||
**/
|
||||
INTN
|
||||
EFIAPI
|
||||
@ -122,9 +110,9 @@ NetGetMaskLength (
|
||||
Return the class of the address, such as class a, b, c.
|
||||
Addr is in host byte order.
|
||||
|
||||
@param Addr The address to get the class from
|
||||
@param[in] Addr The address to get the class from.
|
||||
|
||||
@return IP address class, such as IP4_ADDR_CLASSA
|
||||
@return IP address class, such as IP4_ADDR_CLASSA.
|
||||
|
||||
**/
|
||||
INTN
|
||||
@ -161,10 +149,10 @@ NetGetIpClass (
|
||||
the netmask. If NetMask is zero, use the IP address's class to
|
||||
get the default mask.
|
||||
|
||||
@param Ip The IP to check againist
|
||||
@param NetMask The mask of the IP
|
||||
@param[in] Ip The IP to check against.
|
||||
@param[in] NetMask The mask of the IP.
|
||||
|
||||
@return TRUE if IP is a valid unicast address on the network, otherwise FALSE
|
||||
@return TRUE if IP is a valid unicast address on the network, otherwise FALSE.
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
@ -197,8 +185,6 @@ Ip4IsUnicast (
|
||||
/**
|
||||
Initialize a random seed using current time.
|
||||
|
||||
None
|
||||
|
||||
@return The random seed initialized with current time.
|
||||
|
||||
**/
|
||||
@ -224,7 +210,7 @@ NetRandomInitSeed (
|
||||
Extract a UINT32 from a byte stream, then convert it to host
|
||||
byte order. Use this function to avoid alignment error.
|
||||
|
||||
@param Buf The buffer to extract the UINT32.
|
||||
@param[in] Buf The buffer to extract the UINT32.
|
||||
|
||||
@return The UINT32 extracted.
|
||||
|
||||
@ -246,17 +232,15 @@ NetGetUint32 (
|
||||
Put a UINT32 to the byte stream. Convert it from host byte order
|
||||
to network byte order before putting.
|
||||
|
||||
@param Buf The buffer to put the UINT32
|
||||
@param Data The data to put
|
||||
|
||||
@return None
|
||||
|
||||
@param[in, out] Buf The buffer to put the UINT32.
|
||||
@param[in] Data The data to put.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
NetPutUint32 (
|
||||
IN UINT8 *Buf,
|
||||
IN UINT32 Data
|
||||
IN OUT UINT8 *Buf,
|
||||
IN UINT32 Data
|
||||
)
|
||||
{
|
||||
Data = HTONL (Data);
|
||||
@ -265,9 +249,9 @@ NetPutUint32 (
|
||||
|
||||
|
||||
/**
|
||||
Remove the first entry on the list
|
||||
Remove the first entry on the list.
|
||||
|
||||
@param Head The list header
|
||||
@param[in, out] Head The list header.
|
||||
|
||||
@return The entry that is removed from the list, NULL if the list is empty.
|
||||
|
||||
@ -275,7 +259,7 @@ NetPutUint32 (
|
||||
LIST_ENTRY *
|
||||
EFIAPI
|
||||
NetListRemoveHead (
|
||||
LIST_ENTRY *Head
|
||||
IN OUT LIST_ENTRY *Head
|
||||
)
|
||||
{
|
||||
LIST_ENTRY *First;
|
||||
@ -300,9 +284,9 @@ NetListRemoveHead (
|
||||
|
||||
|
||||
/**
|
||||
Remove the last entry on the list
|
||||
Remove the last entry on the list.
|
||||
|
||||
@param Head The list head
|
||||
@param[in, out] Head The list head.
|
||||
|
||||
@return The entry that is removed from the list, NULL if the list is empty.
|
||||
|
||||
@ -310,7 +294,7 @@ NetListRemoveHead (
|
||||
LIST_ENTRY *
|
||||
EFIAPI
|
||||
NetListRemoveTail (
|
||||
LIST_ENTRY *Head
|
||||
IN OUT LIST_ENTRY *Head
|
||||
)
|
||||
{
|
||||
LIST_ENTRY *Last;
|
||||
@ -335,19 +319,17 @@ NetListRemoveTail (
|
||||
|
||||
|
||||
/**
|
||||
Insert the NewEntry after the PrevEntry
|
||||
Insert the NewEntry after the PrevEntry.
|
||||
|
||||
@param PrevEntry The previous entry to insert after
|
||||
@param NewEntry The new entry to insert
|
||||
|
||||
@return None
|
||||
@param[in, out] PrevEntry The previous entry to insert after.
|
||||
@param[in, out] NewEntry The new entry to insert.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
NetListInsertAfter (
|
||||
IN LIST_ENTRY *PrevEntry,
|
||||
IN LIST_ENTRY *NewEntry
|
||||
IN OUT LIST_ENTRY *PrevEntry,
|
||||
IN OUT LIST_ENTRY *NewEntry
|
||||
)
|
||||
{
|
||||
NewEntry->BackLink = PrevEntry;
|
||||
@ -358,19 +340,17 @@ NetListInsertAfter (
|
||||
|
||||
|
||||
/**
|
||||
Insert the NewEntry before the PostEntry
|
||||
Insert the NewEntry before the PostEntry.
|
||||
|
||||
@param PostEntry The entry to insert before
|
||||
@param NewEntry The new entry to insert
|
||||
|
||||
@return None
|
||||
@param[in, out] PostEntry The entry to insert before.
|
||||
@param[in, out] NewEntry The new entry to insert.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
NetListInsertBefore (
|
||||
IN LIST_ENTRY *PostEntry,
|
||||
IN LIST_ENTRY *NewEntry
|
||||
IN OUT LIST_ENTRY *PostEntry,
|
||||
IN OUT LIST_ENTRY *NewEntry
|
||||
)
|
||||
{
|
||||
NewEntry->ForwardLink = PostEntry;
|
||||
@ -383,15 +363,13 @@ NetListInsertBefore (
|
||||
/**
|
||||
Initialize the netmap. Netmap is a reposity to keep the <Key, Value> pairs.
|
||||
|
||||
@param Map The netmap to initialize
|
||||
|
||||
@return None
|
||||
@param[in, out] Map The netmap to initialize.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
NetMapInit (
|
||||
IN NET_MAP *Map
|
||||
IN OUT NET_MAP *Map
|
||||
)
|
||||
{
|
||||
ASSERT (Map != NULL);
|
||||
@ -405,15 +383,13 @@ NetMapInit (
|
||||
/**
|
||||
To clean up the netmap, that is, release allocated memories.
|
||||
|
||||
@param Map The netmap to clean up.
|
||||
|
||||
@return None
|
||||
@param[in, out] Map The netmap to clean up.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
NetMapClean (
|
||||
IN NET_MAP *Map
|
||||
IN OUT NET_MAP *Map
|
||||
)
|
||||
{
|
||||
NET_MAP_ITEM *Item;
|
||||
@ -445,9 +421,9 @@ NetMapClean (
|
||||
|
||||
|
||||
/**
|
||||
Test whether the netmap is empty
|
||||
Test whether the netmap is empty.
|
||||
|
||||
@param Map The net map to test
|
||||
@param[in] Map The net map to test.
|
||||
|
||||
@return TRUE if the netmap is empty, otherwise FALSE.
|
||||
|
||||
@ -466,7 +442,7 @@ NetMapIsEmpty (
|
||||
/**
|
||||
Return the number of the <Key, Value> pairs in the netmap.
|
||||
|
||||
@param Map The netmap to get the entry number
|
||||
@param[in] Map The netmap to get the entry number.
|
||||
|
||||
@return The entry number in the netmap.
|
||||
|
||||
@ -482,17 +458,18 @@ NetMapGetCount (
|
||||
|
||||
|
||||
/**
|
||||
Allocate an item for the netmap. It will try to allocate
|
||||
Allocate an item for the netmap. It will try to allocate.
|
||||
a batch of items and return one.
|
||||
|
||||
@param Map The netmap to allocate item for
|
||||
@param[in, out] Map The netmap to allocate item for.
|
||||
|
||||
@return The allocated item or NULL
|
||||
@return The allocated item. If NULL, the
|
||||
allocation failed due to resource limit.
|
||||
|
||||
**/
|
||||
NET_MAP_ITEM *
|
||||
NetMapAllocItem (
|
||||
IN NET_MAP *Map
|
||||
IN OUT NET_MAP *Map
|
||||
)
|
||||
{
|
||||
NET_MAP_ITEM *Item;
|
||||
@ -529,18 +506,18 @@ NetMapAllocItem (
|
||||
/**
|
||||
Allocate an item to save the <Key, Value> pair to the head of the netmap.
|
||||
|
||||
@param Map The netmap to insert into
|
||||
@param Key The user's key
|
||||
@param Value The user's value for the key
|
||||
@param[in, out] Map The netmap to insert into.
|
||||
@param[in] Key The user's key.
|
||||
@param[in] Value The user's value for the key.
|
||||
|
||||
@retval EFI_OUT_OF_RESOURCES Failed to allocate the memory for the item
|
||||
@retval EFI_SUCCESS The item is inserted to the head
|
||||
@retval EFI_OUT_OF_RESOURCES Failed to allocate the memory for the item.
|
||||
@retval EFI_SUCCESS The item is inserted to the head.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
NetMapInsertHead (
|
||||
IN NET_MAP *Map,
|
||||
IN OUT NET_MAP *Map,
|
||||
IN VOID *Key,
|
||||
IN VOID *Value OPTIONAL
|
||||
)
|
||||
@ -567,18 +544,18 @@ NetMapInsertHead (
|
||||
/**
|
||||
Allocate an item to save the <Key, Value> pair to the tail of the netmap.
|
||||
|
||||
@param Map The netmap to insert into
|
||||
@param Key The user's key
|
||||
@param Value The user's value for the key
|
||||
@param[in, out] Map The netmap to insert into.
|
||||
@param[in] Key The user's key.
|
||||
@param[in] Value The user's value for the key.
|
||||
|
||||
@retval EFI_OUT_OF_RESOURCES Failed to allocate the memory for the item
|
||||
@retval EFI_SUCCESS The item is inserted to the tail
|
||||
@retval EFI_OUT_OF_RESOURCES Failed to allocate the memory for the item.
|
||||
@retval EFI_SUCCESS The item is inserted to the tail.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
NetMapInsertTail (
|
||||
IN NET_MAP *Map,
|
||||
IN OUT NET_MAP *Map,
|
||||
IN VOID *Key,
|
||||
IN VOID *Value OPTIONAL
|
||||
)
|
||||
@ -604,10 +581,10 @@ NetMapInsertTail (
|
||||
|
||||
|
||||
/**
|
||||
Check whther the item is in the Map
|
||||
Check whther the item is in the Map.
|
||||
|
||||
@param Map The netmap to search within
|
||||
@param Item The item to search
|
||||
@param[in] Map The netmap to search within.
|
||||
@param[in] Item The item to search.
|
||||
|
||||
@return TRUE if the item is in the netmap, otherwise FALSE.
|
||||
|
||||
@ -631,10 +608,10 @@ NetItemInMap (
|
||||
|
||||
|
||||
/**
|
||||
Find the key in the netmap
|
||||
Find the key in the netmap.
|
||||
|
||||
@param Map The netmap to search within
|
||||
@param Key The key to search
|
||||
@param[in] Map The netmap to search within.
|
||||
@param[in] Key The key to search.
|
||||
|
||||
@return The point to the item contains the Key, or NULL if Key isn't in the map.
|
||||
|
||||
@ -664,21 +641,21 @@ NetMapFindKey (
|
||||
|
||||
|
||||
/**
|
||||
Remove the item from the netmap
|
||||
Remove the item from the netmap.
|
||||
|
||||
@param Map The netmap to remove the item from
|
||||
@param Item The item to remove
|
||||
@param Value The variable to receive the value if not NULL
|
||||
@param[in, out] Map The netmap to remove the item from.
|
||||
@param[in, out] Item The item to remove.
|
||||
@param[out] Value The variable to receive the value if not NULL.
|
||||
|
||||
@return The key of the removed item.
|
||||
@return The key of the removed item.
|
||||
|
||||
**/
|
||||
VOID *
|
||||
EFIAPI
|
||||
NetMapRemoveItem (
|
||||
IN NET_MAP *Map,
|
||||
IN NET_MAP_ITEM *Item,
|
||||
OUT VOID **Value OPTIONAL
|
||||
IN OUT NET_MAP *Map,
|
||||
IN OUT NET_MAP_ITEM *Item,
|
||||
OUT VOID **Value OPTIONAL
|
||||
)
|
||||
{
|
||||
ASSERT ((Map != NULL) && (Item != NULL));
|
||||
@ -697,18 +674,18 @@ NetMapRemoveItem (
|
||||
|
||||
|
||||
/**
|
||||
Remove the first entry on the netmap
|
||||
Remove the first entry on the netmap.
|
||||
|
||||
@param Map The netmap to remove the head from
|
||||
@param Value The variable to receive the value if not NULL
|
||||
@param[in, out] Map The netmap to remove the head from.
|
||||
@param[out] Value The variable to receive the value if not NULL.
|
||||
|
||||
@return The key of the item removed
|
||||
@return The key of the item removed.
|
||||
|
||||
**/
|
||||
VOID *
|
||||
EFIAPI
|
||||
NetMapRemoveHead (
|
||||
IN NET_MAP *Map,
|
||||
IN OUT NET_MAP *Map,
|
||||
OUT VOID **Value OPTIONAL
|
||||
)
|
||||
{
|
||||
@ -734,18 +711,18 @@ NetMapRemoveHead (
|
||||
|
||||
|
||||
/**
|
||||
Remove the last entry on the netmap
|
||||
Remove the last entry on the netmap.
|
||||
|
||||
@param Map The netmap to remove the tail from
|
||||
@param Value The variable to receive the value if not NULL
|
||||
@param[in, out] Map The netmap to remove the tail from.
|
||||
@param[out] Value The variable to receive the value if not NULL.
|
||||
|
||||
@return The key of the item removed
|
||||
@return The key of the item removed.
|
||||
|
||||
**/
|
||||
VOID *
|
||||
EFIAPI
|
||||
NetMapRemoveTail (
|
||||
IN NET_MAP *Map,
|
||||
IN OUT NET_MAP *Map,
|
||||
OUT VOID **Value OPTIONAL
|
||||
)
|
||||
{
|
||||
@ -776,11 +753,13 @@ NetMapRemoveTail (
|
||||
from the loop. It returns the CallBack's last return value. This
|
||||
function is delete safe for the current item.
|
||||
|
||||
@param Map The Map to iterate through
|
||||
@param CallBack The callback function to call for each item.
|
||||
@param Arg The opaque parameter to the callback
|
||||
@param[in] Map The Map to iterate through.
|
||||
@param[in] CallBack The callback function to call for each item.
|
||||
@param[in] Arg The opaque parameter to the callback.
|
||||
|
||||
@return It returns the CallBack's last return value.
|
||||
@retval EFI_SUCCESS There is no item in the netmap or CallBack for each item
|
||||
return EFI_SUCCESS.
|
||||
@retval Others It returns the CallBack's last return value.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
@ -822,7 +801,7 @@ NetMapIterate (
|
||||
/**
|
||||
This is the default unload handle for all the network drivers.
|
||||
|
||||
@param ImageHandle The drivers' driver image.
|
||||
@param[in] ImageHandle The drivers' driver image.
|
||||
|
||||
@retval EFI_SUCCESS The image is unloaded.
|
||||
@retval Others Failed to unload the image.
|
||||
@ -936,10 +915,10 @@ NetLibDefaultUnload (
|
||||
/**
|
||||
Create a child of the service that is identified by ServiceBindingGuid.
|
||||
|
||||
@param Controller The controller which has the service installed.
|
||||
@param Image The image handle used to open service.
|
||||
@param ServiceBindingGuid The service's Guid.
|
||||
@param ChildHandle The handle to receive the create child
|
||||
@param[in] Controller The controller which has the service installed.
|
||||
@param[in] Image The image handle used to open service.
|
||||
@param[in] ServiceBindingGuid The service's Guid.
|
||||
@param[in, out] ChildHandle The handle to receive the create child
|
||||
|
||||
@retval EFI_SUCCESS The child is successfully created.
|
||||
@retval Others Failed to create the child.
|
||||
@ -951,7 +930,7 @@ NetLibCreateServiceChild (
|
||||
IN EFI_HANDLE Controller,
|
||||
IN EFI_HANDLE Image,
|
||||
IN EFI_GUID *ServiceBindingGuid,
|
||||
OUT EFI_HANDLE *ChildHandle
|
||||
IN OUT EFI_HANDLE *ChildHandle
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
@ -987,10 +966,10 @@ NetLibCreateServiceChild (
|
||||
/**
|
||||
Destory a child of the service that is identified by ServiceBindingGuid.
|
||||
|
||||
@param Controller The controller which has the service installed.
|
||||
@param Image The image handle used to open service.
|
||||
@param ServiceBindingGuid The service's Guid.
|
||||
@param ChildHandle The child to destory
|
||||
@param[in] Controller The controller which has the service installed.
|
||||
@param[in] Image The image handle used to open service.
|
||||
@param[in] ServiceBindingGuid The service's Guid.
|
||||
@param[in] ChildHandle The child to destory
|
||||
|
||||
@retval EFI_SUCCESS The child is successfully destoried.
|
||||
@retval Others Failed to destory the child.
|
||||
@ -1039,23 +1018,24 @@ NetLibDestroyServiceChild (
|
||||
SnpHandle to a unicode string. Callers are responsible for freeing the
|
||||
string storage.
|
||||
|
||||
@param SnpHandle The handle where the simple network protocol is
|
||||
installed on.
|
||||
@param ImageHandle The image handle used to act as the agent handle to
|
||||
get the simple network protocol.
|
||||
@param MacString The pointer to store the address of the string
|
||||
representation of the mac address.
|
||||
|
||||
@param[in] SnpHandle The handle where the simple network protocol is
|
||||
installed on.
|
||||
@param[in] ImageHandle The image handle used to act as the agent handle to
|
||||
get the simple network protocol.
|
||||
@param[out] MacString The pointer to store the address of the string
|
||||
representation of the mac address.
|
||||
|
||||
@retval EFI_SUCCESS Convert the mac address a unicode string successfully.
|
||||
@retval EFI_OUT_OF_RESOURCES There are not enough memory resource.
|
||||
@retval other Failed to open the simple network protocol.
|
||||
@retval Others Failed to open the simple network protocol.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
NetLibGetMacString (
|
||||
IN EFI_HANDLE SnpHandle,
|
||||
IN EFI_HANDLE ImageHandle,
|
||||
IN OUT CHAR16 **MacString
|
||||
IN EFI_HANDLE SnpHandle,
|
||||
IN EFI_HANDLE ImageHandle,
|
||||
OUT CHAR16 **MacString
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
@ -1111,8 +1091,8 @@ NetLibGetMacString (
|
||||
Check the default address used by the IPv4 driver is static or dynamic (acquired
|
||||
from DHCP).
|
||||
|
||||
@param Controller The controller handle which has the NIC Ip4 Config Protocol
|
||||
relative with the default address to judge.
|
||||
@param[in] Controller The controller handle which has the NIC Ip4 Config Protocol
|
||||
relative with the default address to judge.
|
||||
|
||||
@retval TRUE If the default address is static.
|
||||
@retval FALSE If the default address is acquired from DHCP.
|
||||
@ -1167,16 +1147,15 @@ ON_EXIT:
|
||||
/**
|
||||
Create an IPv4 device path node.
|
||||
|
||||
@param Node Pointer to the IPv4 device path node.
|
||||
@param Controller The handle where the NIC IP4 config protocol resides.
|
||||
@param LocalIp The local IPv4 address.
|
||||
@param LocalPort The local port.
|
||||
@param RemoteIp The remote IPv4 address.
|
||||
@param RemotePort The remote port.
|
||||
@param Protocol The protocol type in the IP header.
|
||||
@param UseDefaultAddress Whether this instance is using default address or not.
|
||||
@param[in, out] Node Pointer to the IPv4 device path node.
|
||||
@param[in] Controller The handle where the NIC IP4 config protocol resides.
|
||||
@param[in] LocalIp The local IPv4 address.
|
||||
@param[in] LocalPort The local port.
|
||||
@param[in] RemoteIp The remote IPv4 address.
|
||||
@param[in] RemotePort The remote port.
|
||||
@param[in] Protocol The protocol type in the IP header.
|
||||
@param[in] UseDefaultAddress Whether this instance is using default address or not.
|
||||
|
||||
@retval None
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
@ -1221,10 +1200,10 @@ NetLibCreateIPv4DPathNode (
|
||||
IP opens these handle BY_DRIVER, use that info, we can get the
|
||||
UNDI/SNP handle.
|
||||
|
||||
@param Controller Then protocol handle to check
|
||||
@param ProtocolGuid The protocol that is related with the handle.
|
||||
@param[in] Controller Then protocol handle to check.
|
||||
@param[in] ProtocolGuid The protocol that is related with the handle.
|
||||
|
||||
@return The UNDI/SNP handle or NULL.
|
||||
@return The UNDI/SNP handle or NULL for errors.
|
||||
|
||||
**/
|
||||
EFI_HANDLE
|
||||
@ -1267,14 +1246,14 @@ NetLibGetNicHandle (
|
||||
/**
|
||||
Add a Deferred Procedure Call to the end of the DPC queue.
|
||||
|
||||
@DpcTpl The EFI_TPL that the DPC should be invoked.
|
||||
@DpcProcedure Pointer to the DPC's function.
|
||||
@DpcContext Pointer to the DPC's context. Passed to DpcProcedure
|
||||
when DpcProcedure is invoked.
|
||||
@param[in] DpcTpl The EFI_TPL that the DPC should be invoked.
|
||||
@param[in] DpcProcedure Pointer to the DPC's function.
|
||||
@param[in] DpcContext Pointer to the DPC's context. Passed to DpcProcedure
|
||||
when DpcProcedure is invoked.
|
||||
|
||||
@retval EFI_SUCCESS The DPC was queued.
|
||||
@retval EFI_INVALID_PARAMETER DpcTpl is not a valid EFI_TPL.
|
||||
DpcProcedure is NULL.
|
||||
@retval EFI_INVALID_PARAMETER DpcTpl is not a valid EFI_TPL, or DpcProcedure
|
||||
is NULL.
|
||||
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to
|
||||
add the DPC to the queue.
|
||||
|
||||
@ -1291,7 +1270,10 @@ NetLibQueueDpc (
|
||||
}
|
||||
|
||||
/**
|
||||
Add a Deferred Procedure Call to the end of the DPC queue.
|
||||
Dispatch the queue of DPCs. ALL DPCs that have been queued with a DpcTpl
|
||||
value greater than or equal to the current TPL are invoked in the order that
|
||||
they were queued. DPCs with higher DpcTpl values are invoked before DPCs with
|
||||
lower DpcTpl values.
|
||||
|
||||
@retval EFI_SUCCESS One or more DPCs were invoked.
|
||||
@retval EFI_NOT_FOUND No DPCs were invoked.
|
||||
@ -1306,15 +1288,14 @@ NetLibDispatchDpc (
|
||||
return mDpc->DispatchDpc(mDpc);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
The constructor function caches the pointer to DPC protocol.
|
||||
|
||||
The constructor function locates DPC protocol from protocol database.
|
||||
It will ASSERT() if that operation fails and it will always return EFI_SUCCESS.
|
||||
|
||||
@param ImageHandle The firmware allocated handle for the EFI image.
|
||||
@param SystemTable A pointer to the EFI System Table.
|
||||
@param[in] ImageHandle The firmware allocated handle for the EFI image.
|
||||
@param[in] SystemTable A pointer to the EFI System Table.
|
||||
|
||||
@retval EFI_SUCCESS The constructor always returns EFI_SUCCESS.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user