WdfFdoInitSetDefaultChildListConfig function (wdffdo.h)

Artikel
02/22/2024

[Applies to KMDF only]

The WdfFdoInitSetDefaultChildListConfig method configures a bus driver's default child list.

Syntax

void WdfFdoInitSetDefaultChildListConfig(
  [in, out]      PWDFDEVICE_INIT        DeviceInit,
  [in]           PWDF_CHILD_LIST_CONFIG Config,
  [in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);

Parameters

[in, out] DeviceInit

A pointer to a WDFDEVICE_INIT structure that the driver obtained from its EvtDriverDeviceAdd callback function.

[in] Config

A pointer to a driver-allocated WDF_CHILD_LIST_CONFIG structure.

[in, optional] DefaultChildListAttributes

A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains object attributes for the child-list object that represents the driver's default child list. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.

Return value

None

Remarks

A bus driver must call WdfFdoInitSetDefaultChildListConfig before calling WdfDeviceCreate for the functional device object (FDO). For more information about calling WdfDeviceCreate, see Creating a Framework Device Object.

For more information about the WdfFdoInitSetDefaultChildListConfig method, see Enumerating the Devices on a Bus.

Examples

The following code example initializes a WDF_CHILD_LIST_CONFIG structure and then calls WdfFdoInitSetDefaultChildListConfig.

WDF_CHILD_LIST_CONFIG  config;

WDF_CHILD_LIST_CONFIG_INIT(
                           &config,
 sizeof(MY_IDENTIFICATION_DESCRIPTION),
                           My_EvtDeviceListCreatePdo
                           );
config.EvtChildListIdentificationDescriptionDuplicate = My_EvtChildListIdentificationDescriptionDuplicate;
config.EvtChildListIdentificationDescriptionCompare = My_EvtChildListIdentificationDescriptionCompare;
config.EvtChildListIdentificationDescriptionCleanup = My_EvtChildListIdentificationDescriptionCleanup;

WdfFdoInitSetDefaultChildListConfig(
                                    DeviceInit,
                                    &config,
                                    WDF_NO_OBJECT_ATTRIBUTES
                                    );

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Header	wdffdo.h (include Wdf.h)
Library	Wdf01000.sys (see Framework Library Versioning.)
IRQL	PASSIVE_LEVEL
DDI compliance rules	ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Delen via