Efi Protocols - Intel Extensible Firmware Interface Specification

Extensible Firmware Interface Specification
The following C code fragment illustrates the use of protocols:
// There is a global "EffectsDevice" structure.
// structure contains information pertinent to the device.
// Connect to the ILLUSTRATION_PROTOCOL on the EffectsDevice,
// by calling HandleProtocol with the device's EFI device handle
// and the ILLUSTRATION_PROTOCOL GUID.
EffectsDevice.Handle = DeviceHandle;
Status = HandleProtocol (
// Use the EffectsDevice illustration protocol's "MakeEffects"
// service to make flashy and noisy effects.
Status = EffectsDevice.IllustrationProtocol->MakeEffects (
Table 2-4 lists the EFI protocols defined by this specification.
Table 2-4.

EFI Protocols

Protocol Name
BLOCK_IO
DEVICE_IO
DEVICE_PATH
DISK_IO
SIMPLE_FILE_SYSTEM
EFI_FILE_HANDLE
LOAD_FILE
LOADED_IMAGE
PXE_BC
SERIAL_IO
SIMPLE_INPUT
SIMPLE_TEXT_OUTPUT
SIMPLE_NETWORK
UNICODE_COLLATION
20
EffectsDevice.EFIHandle,
&IllustrationProtocolGuid,
&EffectsDevice.IllustrationProtocol
);
EffectsDevice.IllustrationProtocol,
TheFlashyAndNoisyEffect
);
Description
Protocol interfaces for devices that support block I/O style accesses.
Protocol interfaces for performing device I/O.
Provides the location of the device.
A protocol interface that layers onto any BLOCK_IO interface.
Protocol interfaces for opening disk volume containing an EFI file system.
Provides access to supported file systems.
Protocol interface for reading a file from an arbitrary device.
Provides information on the image.
Protocol interfaces for devices that support network booting.
Protocol interfaces for devices that support serial character transfer.
Protocol interfaces for devices that support simple console style text input.
Protocol interfaces for devices that support console style text displaying.
Provides interface for devices that support packet based transfers.
Protocol interfaces for Unicode string comparison operations.
12/12/00
This
Version 1.02