WdfDriverWdmGetDriverObject-Funktion (wdfdriver.h)

[Gilt nur für KMDF]

Die WdfDriverWdmGetDriverObject-Methode ruft einen Zeiger auf das WDM-Treiberobjekt (Windows Driver Model) ab, das einem angegebenen Frameworktreiberobjekt zugeordnet ist.

Syntax

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

Parameter

[in] Driver

Ein Handle für das Frameworktreiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver abgerufen hat.

Rückgabewert

WdfDriverWdmGetDriverObject gibt einen Zeiger auf eine DRIVER_OBJECT-Struktur zurück. Wenn das Treiberhandle ungültig ist, tritt eine Systemfehlerprüfung auf.

Hinweise

Der Zeiger, den die WdfDriverWdmGetDriverObject-Methode zurückgibt, ist gültig, bis das Frameworktreiberobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback-Funktion für das Frameworktreiberobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

Beispiele

Im folgenden Codebeispiel wird ein Zeiger auf das WDM-Treiberobjekt abgerufen, das einem angegebenen Frameworktreiberobjekt zugeordnet ist.

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

Anforderungen

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

Weitere Informationen

DRIVER_OBJECT

WdfDriverErstellen

WdfGetDriver