Handleprotocol() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.3.6

HandleProtocol()

Summary
Queries a handle to determine if it supports a specified protocol.
Prototype
EFI_STATUS
HandleProtocol (
IN EFI_HANDLE
IN EFI_GUID
OUT VOID
);
Parameters
Handle
Protocol
Interface
Description
The
HandleProtocol()
does, then on return
can then be passed to any Protocol Service to identify the context of the request.
Interface
Status Codes Returned
EFI_SUCCESS
EFI_UNSUPPORTED
EFI_INVALID_PARAMETER
64
Handle,
*Protocol,
**Interface
The handle being queried. Type
Section 3.3.1. If
Handle
EFI_INVALID_PARAMETER
The published unique identifier of the protocol. Type
defined in Section 3.3.1. It is the callers responsibility to pass in a valid
GUID. See "Wired For Management Baseline" for a description of valid
GUID values.
Supplies the address where a pointer to the corresponding Protocol
Interface is returned.
structure is not associated with Protocol.
function queries Handle to determine if it supports Protocol. If it
points to a pointer to the corresponding Protocol Interface.
Interface
The interface information for the specified protocol was returned.
The device does not support the specified protocol.
One of the parameters has an invalid value.
12/12/00
EFI_HANDLE
is not a valid EFI_HANDLE, then
is returned.
will be returned in
NULL *Interface
is defined in
is
EFI_GUID
if a
Version 1.02