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.