Intel Extensible Firmware Interface, Specification

Page: 78 / 494

Extensible Firmware Interface Specification
60 12/12/00 Version 1.02
3.3.3 ReinstallProtocolInterface()
Summary
Reinstalls a protocol interface on a device handle.
Prototype
EFI_STATUS
ReinstallProtocolInterface (
IN EFI_HANDLE
Handle,
IN EFI_GUID *Protocol,
IN VOID *OldInterface,
IN VOID *NewInterface
);
Parameters
Handle
Handle on which the interface is to be reinstalled. Type
EFI_HANDLE
is defined in Section 3.3.1. If
Handle
is not a valid handle, then
EFI_INVALID_PARAMETER is returned.
Protocol
The numeric ID of the interface. Type
EFI_GUID
is defined in
Section 3.3.1. It is the callers responsibility to pass in a valid GUID.
See “Wired For Management Baseline” for a description of valid GUID
values.
OldInterface
A pointer to the old interface.
NULL
can be used if a structure is not
associated with
Protocol
.
NewInterface
A pointer to the new interface.
NULL
can be used if a structure is not
associated with
Protocol
.
Description
The
ReinstallProtocolInterface()
function reinstalls a protocol interface on a device
handle. The
OldInterface
for
Protocol
is replaced by the
NewInterface
.
NewInterface
may be the same as
OldInterface
. If it is, the registered protocol notifies
occur for the handle without replacing the interface on the handle.
As with
InstallProtocolInterface()
, any process that has registered to wait for the
installation of the interface is notified. For more information, see Section 3.3.4.
The caller is responsible for ensuring that there are no references to the
OldInterface
that is
being removed.
Status Codes Returned
EFI_SUCCESS The protocol interface was installed.
EFI_NOT_FOUND
The OldInterface on the handle was not found.
EFI_INVALID_PARAMETER One of the parameters has an invalid value.