Intel Extensible Firmware Interface - Manual (Page 144)

Extensible Firmware Interface Specification
5-46 12/01/02 Version 1.10
EFI 1.10 Extension
The HandleProtocol() function is still available for use by old EFI applications and drivers.
However, all new applications and drivers should use OpenProtocol() in place of
HandleProtocol() . The following code fragment shows a possible implementation of
HandleProtocol() using OpenProtocol() . The variable EfiCoreImageHandle is the
image handle of the EFI core.
EFI_STATUS
HandleProtocol (
IN EFI_HANDLE Handle,
IN EFI_GUID *Protocol,
OUT VOID **Interface
)
{
return OpenProtocol (
Handle,
Protocol,
Interface,
EfiCoreImageHandle,
NULL,
EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL
);
}
Status Codes Returned
EFI_SUCCESS The interface information for the specified protocol was returned.
EFI_UNSUPPORTED The device does not support the specified protocol.
EFI_INVALID_PARAMETER One of the parameters has an invalid value.