Filter
Top Products
Services — Boot Services
Version 1.10 12/01/02 5-31
5.3 Protocol Handler Services
In the abstract, a protocol consists of a 128-bit globally unique identifier (GUID) and a Protocol
Interface structure. The structure contains the functions and instance data that are used to access a
device. The functions that make up Protocol Handler Services allow applications to install a
protocol on a handle, identify the handles that support a given protocol, determine whether a handle
supportsagivenprotocol,andsoforth. SeeTable5-7.
Table 5-7. Protocol Interface Functions
Name Type Description
InstallProtocolInterface Boot Installs a protocol interface on a device handle.
UninstallProtocolInterface Boot Removes a protocol interface from a device handle.
ReinstallProtocolInterface Boot Reinstalls a protocol interface on a device handle.
RegisterProtocolNotify Boot Registers an event that is to be signaled whenever an
interface is installed for a specified protocol.
LocateHandle Boot Returns an array of handles that support a specified
protocol.
HandleProtocol Boot Queries a handle to determine if it supports a specified
protocol.
LocateDevicePath Boot Locates all devices on a device path that support a
specified protocol and returns the handle to the device
that is closest to the path.
OpenProtocol Boot Adds elements to the list of agents consuming a protocol
interface.
CloseProtocol Boot Removes elements from the list of agents consuming a
protocol interface.
OpenProtocolInformation Boot Retrieve the list of agents that are currently consuming a
protocol interface.
ConnectController Boot Uses a set of precedence rules to find the best set of
drivers to manage a controller.
DisconnectController Boot Informs a set of drivers to stop managing a controller.
ProtocolsPerHandle Boot Retrieves the list of protocols installed on a handle. The
return buffer is automatically allocated.
LocateHandleBuffer Boot Retrieves the list of handles from the handle database
that meet the search criteria. The return buffer is
automatically allocated.
LocateProtocol Boot Finds the first handle in the handle database the
supports the requested protocol.
InstallMultipleProtocolInterfaces Boot Installs one or more protocol interfaces onto a handle.
UninstallMultipleProtocolInterfaces Boot Uninstalls one or more protocol interfaces from a handle.