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 WDFDEVICE_INIT ottenuta dal driver dalla relativa funzione di callback EvtDriverDeviceAdd .
[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 ( FDO). Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo framework.
Per altre informazioni sul metodo WdfFdoInitSetDefaultChildListConfig , vedere Enumerazione dei dispositivi in un bus.
Esempio
L'esempio di codice seguente inizializza una struttura WDF_CHILD_LIST_CONFIG e quindi chiama 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 KMDF minima | 1.0 |
| Intestazione | wdffdo.h (include Wdf.h) |
| Libreria | 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) |