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.