Reinstallprotocolinterface() - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
3.3.3

ReinstallProtocolInterface()

Summary
Reinstalls a protocol interface on a device handle.
Prototype
EFI_STATUS
ReinstallProtocolInterface (
IN EFI_HANDLE
IN EFI_GUID
IN VOID
IN VOID
);
Parameters
Handle
Protocol
OldInterface
NewInterface
Description
The
ReinstallProtocolInterface()
handle. The
OldInterface
may be the same as OldInterface. If it is, the registered protocol notifies
NewInterface
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
being removed.
Status Codes Returned
EFI_SUCCESS
EFI_NOT_FOUND
EFI_INVALID_PARAMETER
60
Handle,
*Protocol,
*OldInterface,
*NewInterface
Handle on which the interface is to be reinstalled. Type
is defined in Section 3.3.1. If
EFI_INVALID_PARAMETER is returned.
The numeric ID of the interface. Type
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.
A pointer to the old interface.
associated with Protocol.
A pointer to the new interface.
associated with Protocol.
function reinstalls a protocol interface on a device
for is replaced by the NewInterface.
Protocol
The protocol interface was installed.
OldInterface
The
One of the parameters has an invalid value.
12/12/00
is not a valid handle, then
Handle
is defined in
EFI_GUID
can be used if a structure is not
NULL
can be used if a structure is not
NULL
OldInterface
on the handle was not found.
Version 1.02
EFI_HANDLE
that is