Intel Extensible Firmware Interface - Manual (Page 280)

Extensible Firmware Interface Specification
9-38 12/01/02 Version 1.10
EFI_DRIVER_CONFIGURATION_PROTOCOL.OptionsValid()
Summary
Tests to see if a controller’s current configuration options are valid.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_DRIVER_CONFIGURATION_OPTIONS_VALID) (
IN EFI_DRIVER_CONFIGURATION_PROTOCOL
*This,
IN EFI_HANDLE ControllerHandle,
IN EFI_HANDLE ChildHandle OPTIONAL
);
Parameters
This A pointer to the EFI_DRIVER_CONFIGURATION_
PROTOCOL instance.
ControllerHandle The handle of the controller to test if it’s current configuration
options are valid.
ChildHandle The handle of the child controller to test if it’s current
configuration options are valid. This is an optional parameter
that may be
NULL . It will be NULL for device drivers. It will
also be NULL for a bus drivers that wish to test the configuration
options for the bus controller. It will not be NULL for a bus
driver that wishes to test configuration options for one of its
child controllers.
Description
This function tests to see if the configuration options for the driver specified by This on the
controller specified by ControllerHandle and ChildHandle are valid. If they are, then
EFI_SUCCESS is returned. If they are not valid, then EFI_DEVICE_ERROR is returned. If the
controller specified by ControllerHandle and ChildHandle is not currently being managed
by the driver specified by This , then EFI_UNSUPPORTED is returned. This function is not
allowed to interact with the user. Since the driver is responsible for maintaining the configuration
options for each controller it manages, the exact method by which the configuration options are
validated is driver specific.