Intel Extensible Firmware Interface, Specification

Page: 75 / 494

Services
Version 1.02 12/12/00 57
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 *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 or p-code 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
.