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