Locatehandle() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.3.5

LocateHandle()

Summary
Returns an array of handles that support a specified protocol.
Prototype
EFI_STATUS
LocateHandle (
IN EFI_LOCATE_SEARCH_TYPE
IN EFI_GUID
IN VOID
IN OUT UINTN
OUT EFI_HANDLE
);
Parameters
SearchType
Protocol
SearchKey
BufferSize
Buffer
62
SearchType,
*Protocol OPTIONAL,
*SearchKey OPTIONAL,
*BufferSize,
*Buffer
Specifies which handle(s) are to be returned. Type
EFI_LOCATE_SEARCH_TYPE
Specifies the protocol to search by. This parameter is only valid if
is
SearchType ByProtocol.
Section 3.3.1.
Specifies the search key. This parameter is ignored if
or ByProtocol. If
AllHandles
ByRegisterNotify, the parameter must be the
value returned by function
On input, the size in bytes of Buffer. On output, the size in bytes of
the array returned in
Buffer
size, in bytes, of the buffer needed to obtain the array (if the buffer was
not large enough).
The buffer in which the array is returned. Type
defined in Section 3.3.1.
12/12/00
is defined in "Related Definitions".
Type
EFI_GUID
SearchType
Registration
RegisterNotifyProtocol().
(if the buffer was large enough) or the
EFI_HANDLE
is defined in
is
SearchType
is
is
Version 1.02