Intel Extensible Firmware Interface Specification page 81

Related Definitions
//*******************************************************
// EFI_LOCATE_SEARCH_TYPE
//*******************************************************
typedef enum {
AllHandles,
ByRegisterNotify,
ByProtocol
} EFI_LOCATE_SEARCH_TYPE;
AllHandles
ByRegisterNotify
ByProtocol
Description
The
LocateHandle()
request. If the input value of
EFI_BUFFER_TOO_SMALL
the array.
Status Codes Returned
EFI_SUCCESS
EFI_NOT_FOUND
EFI_BUFFER_TOO_SMALL
EFI_INVALID_PARAMETER
Version 1.02
and
Protocol SearchKey
returns an array of every handle in the system.
supplies the
SearchKey
RegisterProtocolNotify(). The function returns the
next handle that is new for the registration. Only one handle is
returned at a time, and the caller must loop until no more handles
are returned.
Protocol
All handles that support
is ignored for this search type.
function returns an array of handles that match the
is too small, the function returns
BufferSize
and updates
BufferSize
The array of handles was returned.
No handles match the search.
The
BufferSize
has been updated with the size needed to
BufferSize
complete the request.
One of the parameters has an invalid value.
12/12/00
are ignored and the function
value returned by
Registration
is ignored for this search type.
are returned.
Protocol
SearchType
to the size of the buffer needed to obtain
is too small for the result.
Services
SearchKey
63