Uninstallprotocolinterface() - Intel Extensible Firmware Interface Specification

3.3.2

UninstallProtocolInterface()

Summary
Removes a protocol interface from a device handle.
Prototype
EFI_STATUS
UninstallProtocolInterface (
IN EFI_HANDLE
IN EFI_GUID
IN VOID
);
Parameters
Handle
Protocol
Interface
Description
The
UninstallProtocolInterface()
handle on which it was previously installed. The
protocol interface to remove from the handle.
The caller is responsible for ensuring that there are no references to a protocol interface that has
been removed. In some cases, outstanding reference information is not available in the protocol, so
the protocol, once added, cannot be removed. Examples include Console I/O, Block I/O, Disk I/O,
and (in general) handles to device protocols.
If the last protocol interface is removed from a handle, the handle is freed and is no longer valid.
Status Codes Returned
EFI_SUCCESS
EFI_NOT_FOUND
EFI_INVALID_PARAMETER
Version 1.02
The handle on which the interface was installed. Type
defined in Section 3.3.1. If
EFI_INVALID_PARAMETER
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 interface.
associated with Protocol.
function removes a protocol interface from the
Protocol
The interface was removed.
The interface was not found.
One of the parameters has an invalid value.
12/12/00
Handle,
*Protocol,
*Interface
is not a valid handle, then
Handle
is returned.
is defined in
EFI_GUID
can be used if a structure is not
NULL
and
Interface
Services
is
EFI_HANDLE
values define the
59