Installprotocolinterface() - Intel Extensible Firmware Interface Specification

3.3.1

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
IN EFI_GUID
IN EFI_INTERFACE_TYPE
IN VOID
);
Parameters
Handle
Protocol
InterfaceType
Interface
Version 1.02
A pointer to the
EFI_HANDLE
If is on input, a new handle is created and returned on
*Handle
NULL
output. If is not
*Handle
handle, and the handle is returned unmodified. The type
is defined in "Related Definitions". If
then
EFI_INVALID_PARAMETER
The numeric ID of the protocol interface. The type
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.
Indicates whether
Interface
This value indicates the original execution environment of the request.
See "Related Definitions".
A pointer to the protocol interface. The
structure defined by Protocol.
associated with Protocol.
12/12/00
*Handle,
*Protocol,
InterfaceType,
*Interface
on which the interface is to be installed.
on input, the protocol is added to the
NULL
is not a valid handle,
*Handle
is returned.
EFI_GUID
is supplied in native or p-code form.
Interface
can be used if a structure is not
NULL
Services
EFI_HANDLE
is
must adhere to the
57