Filter
Top Products
Extensible Firmware Interface Specification
5-68 12/01/02 Version 1.10
ProtocolsPerHandle()
Summary
Retrieves the list of protocol interface GUIDs that are installed on a handle in a buffer allocated
from pool.
Prototype
typedef
EFI_STATUS
ProtocolsPerHandle (
IN EFI_HANDLE Handle,
OUT EFI_GUID ***ProtocolBuffer,
OUT UINTN *ProtocolBufferCount
);
Parameters
Handle The handle from which to retrieve the list of protocol interface
GUIDs.
ProtocolBuffer A pointer to the list of protocol interface GUID pointers that are
installed on Handle. This buffer is allocated with a call to the
Boot Service AllocatePool()
. It is the caller's
responsibility to call the Boot Service FreePool()
when the
caller no longer requires the contents of ProtocolBuffer.
ProtocolBufferCount A pointer to the number of GUID pointers present in
ProtocolBuffer.
Description
The ProtocolsPerHandle() function retrieves the list of protocol interface GUIDs that are
installed on Handle. The list is returned in ProtocolBuffer, and the number of GUID
pointers in ProtocolBuffer is returned in ProtocolBufferCount.
If Handle is NULL or Handle is not a valid EFI_HANDLE,thenEFI_INVALID_PARAMETER
is returned.
If ProtocolBuffer is NULL,thenEFI_INVALID_PAREMETER is returned.
If ProtocolBufferCount is NULL,thenEFI_INVALID_PARAMETER is returned.
If there are not enough resources available to allocate ProtocolBuffer,then
EFI_OUT_OF_RESOURCES is returned.