Efi 1.10 extension, Status codes returned – Intel Extensible Firmware Interface User 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
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.