Registerprotocolnotify() - Intel Extensible Firmware Interface Specification

3.3.4

RegisterProtocolNotify()

Summary
Creates an event that is to be signaled whenever an interface is installed for a specified protocol.
Prototype
EFI_STATUS
RegisterProtocolNotify (
IN EFI_GUID
IN EFI_EVENT
OUT VOID
);
Parameters
Protocol
Event
Registration
Description
The
RegisterProtocolNotify()
protocol interface is installed for
ReinstallProtocolInterface().
Once Event has been signaled, the
newly installed, or reinstalled, handles that support Protocol. The Registration parameter
in
RegisterProtocolNotify()
LocateHandle(). Note that the same handle may be returned multiple times if the handle
reinstalls the target protocol ID multiple times. This is typical for removable media devices,
because when such a device reappears, it will reinstall the Block I/O protocol to indicate that the
device needs to be checked again. In response, layered Disk I/O and Simple File System protocols
may then reinstall their protocols to indicate that they can be re-checked, and so forth.
Status Codes Returned
EFI_SUCCESS
EFI_OUT_OF_RESOURCES
EFI_INVALID_PARAMETER
Version 1.02
*Protocol,
Event,
**Registration
The numeric ID of the protocol for which the event is to be registered.
Type is defined in Section 3.3.1.
EFI_GUID
Event that is to be signaled whenever a protocol interface is registered
for Protocol. Type
EFI_EVENT
A pointer to a memory location to receive the registration value. This
value must be saved and used by the notification function of
retrieve the list of handles that have added a protocol interface of type
Protocol.
function creates an event that is to be signaled whenever a
by
Protocol
InstallProtocolInterface()
LocateHandle()
corresponds to the SearchKey parameter in
The notification event has been registered.
Space for the notification event could not be allocated.
One of the parameters has an invalid value.
12/12/00
is defined in Section 3.1.1.
function can be called to identify the
Services
to
Event
or
61