Efi_driver_configuration_protocol.optionsvalid(), Optionsvalid(), Func – Intel Extensible Firmware Interface User 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
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.