Funzione WdfFdoInitSetDefaultChildListConfig (wdffdo.h)

[Si applica solo a KMDF]

Il metodo WdfFdoInitSetDefaultChildListConfig configura l'elenco figlio predefinito di un driver del bus.

Sintassi

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

Parametri

[in, out] DeviceInit

Puntatore a una struttura di WDFDEVICE_INIT ottenuta dal driver dal relativo EvtDriverDeviceAdd funzione di callback.

[in] Config

Puntatore a una struttura di WDF_CHILD_LIST_CONFIG allocata dal driver.

[in, optional] DefaultChildListAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante che contiene gli attributi oggetto per l'oggetto elenco figlio che rappresenta l'elenco figlio predefinito del driver. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

Valore restituito

Nessuno

Osservazioni:

Un driver del bus deve chiamare WdfFdoInitSetDefaultChildListConfig prima di chiamare WdfDeviceCreate per l'oggetto dispositivo funzionale. Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object.

Per altre informazioni sul metodo di WdfFdoInitSetDefaultChildListConfig, vedere Enumerating the Devices on a Bus.For more information about the WdfFdoInitSetDefaultChildListConfig method, see Enumerating the Devices on a Bus.

Esempi

Nell'esempio di codice seguente viene inizializzata una struttura WDF_CHILD_LIST_CONFIG e quindi viene chiamato 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
                                    );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdffdo.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	PASSIVE_LEVEL
regole di conformità DDI	ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreare