WdfChildListGetDevice-Funktion (wdfchildlist.h)

Artikel
02/07/2025

[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 untergeordnetes Listenobjekt.

Rückgabewert

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

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

Bemerkungen

Weitere Informationen zu untergeordneten Listen finden Sie unter dynamische Enumeration.

Beispiele

Das folgende Codebeispiel ruft ein Handle für das Geräteobjekt ab, das das übergeordnete Gerät einer untergeordneten Liste darstellt.

WDFDEVICE parentDevice;

parentDevice = WdfChildListGetDevice(ChildList);

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfchildlist.h (include Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über