Intel Extensible Firmware Interface - Manual (Page 166)

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 , then EFI_INVALID_PARAMETER
is returned.
If ProtocolBuffer is NULL , then EFI_INVALID_PAREMETER is returned.
If ProtocolBufferCount is NULL , then EFI_INVALID_PARAMETER is returned.
If there are not enough resources available to allocate ProtocolBuffer , then
EFI_OUT_OF_RESOURCES is returned.