WdfFdoInitSetDefaultChildListConfig-Funktion (wdffdo.h)

[Gilt nur für KMDF]

Die WdfFdoInitSetDefaultChildListConfig Methode konfiguriert die Standard-untergeordnete Liste eines Bustreibers.

Syntax

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

Die Parameter

[in, out] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur, die der Treiber aus seiner EvtDriverDeviceAdd Rückruffunktion 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 Standard-untergeordnete Liste des Treibers darstellt. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

Rückgabewert

Nichts

Bemerkungen

Ein Bustreiber muss WdfFdoInitSetDefaultChildListConfig aufrufen, bevor WdfDeviceCreate für das funktionale Geräteobjekt (FDO) aufgerufen wird. Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Weitere Informationen zur WdfFdoInitSetDefaultChildListConfig--Methode finden Sie unter Aufzählen der Geräte auf einem Bus-.

Beispiele

Im folgenden Codebeispiel wird eine WDF_CHILD_LIST_CONFIG Struktur initialisiert und anschließend WdfFdoInitSetDefaultChildListConfigaufgerufen.

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
Minimale KMDF-Version	1.0
Kopfzeile	wdffdo.h (include Wdf.h)
Bibliothek	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate