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