Freigeben über


WdfFdoGetDefaultChildList-Funktion (wdffdo.h)

[Gilt nur für KMDF]

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

Syntax

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

Die Parameter

[in] Fdo

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

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

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

Bemerkungen

Vor dem Aufrufen WdfFdoGetDefaultChildListmuss Ihr Treiber WdfFdoInitSetDefaultChildListConfig- aufrufen, um die standard 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 erhalten.

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Anforderungen

Anforderung Wert
Zielplattform universell
Minimale KMDF-Version 1.0
Kopfzeile wdffdo.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfFdoInitSetDefaultChildListConfig