WdfChildListGetDevice-Funktion (wdfchildlist.h)

Artikel
02/29/2024

[Gilt nur für KMDF]

Die WdfChildListGetDevice-Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das das übergeordnete Gerät einer angegebenen untergeordneten Liste darstellt.

Syntax

WDFDEVICE WdfChildListGetDevice(
  [in] WDFCHILDLIST ChildList
);

Parameter

[in] ChildList

Ein Handle für ein Framework-Objekt mit untergeordneter Liste.

Rückgabewert

WdfChildListGetDevice gibt ein Handle an ein Framework-Geräteobjekt zurück.

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

Hinweise

Weitere Informationen zu untergeordneten Listen finden Sie unter Dynamische Enumeration.

Beispiele

Im folgenden Codebeispiel wird ein Handle für das Geräteobjekt abgerufen, das das übergeordnete Gerät einer untergeordneten Liste darstellt.

WDFDEVICE parentDevice;

parentDevice = WdfChildListGetDevice(ChildList);

Anforderungen

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

Freigeben über