WdfFdoInitSetDefaultChildListConfig-Funktion (wdffdo.h)

  • Artikel

[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)

Weitere Informationen

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate