Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die WdfDriverWdmGetDriverObject-Methode ruft einen Zeiger auf das Windows Driver Model (WDM)-Treiberobjekt ab, das einem angegebenen Frameworktreiberobjekt zugeordnet ist.
Syntax
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
Die Parameter
[in] Driver
Ein Handle für das Framework-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriverabgerufen hat.
Rückgabewert
WdfDriverWdmGetDriverObject gibt einen Zeiger auf eine DRIVER_OBJECT Struktur zurück. Eine Systemfehlerüberprüfung tritt auf, wenn das Treiber- Handle ungültig ist.
Bemerkungen
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 Framework-Treiberobjekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.
Beispiele
Das folgende Codebeispiel ruft einen Zeiger auf das WDM-Treiberobjekt ab, das einem angegebenen Frameworktreiberobjekt zugeordnet ist.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdriver.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |