WdfFdoInitSetDefaultChildListConfig-Funktion (wdffdo.h)
[Gilt nur für KMDF]
Die WdfFdoInitSetDefaultChildListConfig-Methode konfiguriert die untergeordnete Standardliste eines Bustreibers.
Syntax
void WdfFdoInitSetDefaultChildListConfig(
[in, out] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_CHILD_LIST_CONFIG Config,
[in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);
Parameter
[in, out] DeviceInit
Ein Zeiger auf eine WDFDEVICE_INIT Struktur, die der Treiber aus seiner Rückruffunktion EvtDriverDeviceAdd abgerufen hat.
[in] Config
Ein Zeiger auf eine vom Treiber zugewiesene WDF_CHILD_LIST_CONFIG-Struktur .
[in, optional] DefaultChildListAttributes
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das untergeordnete Objekt enthält, das die untergeordnete Standardliste des Treibers darstellt. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
Rückgabewert
Keine
Bemerkungen
Ein Bustreiber muss WdfFdoInitSetDefaultChildListConfig aufrufen, bevor WdfDeviceCreate für das funktionale Geräteobjekt (Functional Device Object, FDO) aufgerufen wird. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.
Weitere Informationen zur WdfFdoInitSetDefaultChildListConfig-Methode finden Sie unter Auflisten der Geräte in einem Bus.
Beispiele
Im folgenden Codebeispiel wird eine WDF_CHILD_LIST_CONFIG-Struktur initialisiert und dann WdfFdoInitSetDefaultChildListConfig aufgerufen.
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
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdffdo.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |