WdfFdoGetDefaultChildList-Funktion (wdffdo.h)

[Gilt nur für KMDF]

Die WdfFdoGetDefaultChildList-Methode gibt ein Handle an die standardmäßige untergeordnete Liste eines angegebenen Geräts zurück.

Syntax

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

Parameter

[in] Fdo

Ein Handle für ein Framework-Geräteobjekt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfFdoGetDefaultChildList ein Handle an die standardmäßige untergeordnete Liste zurück, die dem von Fdo angegebenen Gerät zugeordnet ist. Andernfalls gibt die Methode NULL zurück.

Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Vor dem Aufrufen von WdfFdoGetDefaultChildList muss Ihr Treiber WdfFdoInitSetDefaultChildListConfig aufrufen, um die standardmäßige untergeordnete Liste zu konfigurieren. Andernfalls gibt WdfFdoGetDefaultChildListNULL zurück.

Weitere Informationen zu untergeordneten Listen finden Sie unter Dynamische Enumeration.

Beispiele

Im folgenden Codebeispiel wird ein Handle für die standardmäßige untergeordnete Liste eines Geräts abgerufen.

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdffdo.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfFdoInitSetDefaultChildListConfig