Intel Extensible Firmware Interface - Manual (Page 134)

Extensible Firmware Interface Specification
5-36 12/01/02 Version 1.10
InstallProtocolInterface()
Summary
Installs a protocol interface on a device handle. If the handle does not exist, it is created and added
to the list of handles in the system.
Prototype
EFI_STATUS
InstallProtocolInterface (
IN OUT EFI_HANDLE *Handle,
IN EFI_GUID *Protocol,
IN EFI_INTERFACE_TYPE InterfaceType,
IN VOID *Interface
);
Parameters
Handle A pointer to the EFI_HANDLE on which the interface is to be installed.
If *Handle is NULL on input, a new handle is created and returned on
output. If *Handle is not NULL on input, the protocol is added to the
handle, and the handle is returned unmodified. The type EFI_HANDLE
is defined in “Related Definitions.” If *Handle is not a valid handle,
then EFI_INVALID_PARAMETER is returned.
Protocol The numeric ID of the protocol interface. The type EFI_GUID is
defined in “Related Definitions.” It is the callers responsibility to pass in
a valid GUID. See “Wired For Management Baseline” for a description
of valid GUID values.
InterfaceType Indicates whether Interface is supplied in native form. This value
indicates the original execution environment of the request. See
“Related Definitions.”
Interface A pointer to the protocol interface. The Interface must adhere to the
structure defined by Protocol . NULL can be used if a structure is not
associated with Protocol .