WdfWdmDeviceGetWdfDeviceHandle-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfWdmDeviceGetWdfDeviceHandle-Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das einem angegebenen WDM-Geräteobjekt zugeordnet ist.
Syntax
WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Ein Zeiger auf eine WDM-DEVICE_OBJECT Struktur, die der aufrufende Treiber erstellt hat.
Rückgabewert
Wenn das angegebene WDM-Geräteobjekt gültig ist, gibt WdfWdmDeviceGetWdfDeviceHandle ein Handle an das zugeordnete Framework-Geräteobjekt zurück. Andernfalls gibt die Methode NULL zurück.
Hinweise
Die WDM-DEVICE_OBJECT Struktur, die der Treiber für den DeviceObject-Parameter angibt, muss ein Geräteobjekt darstellen, das der aufrufende Treiber erstellt hat. Die -Struktur kann beispielsweise keines der WDM-Geräteobjekte darstellen, die der Treiber in einem vorherigen Aufruf von WdfDeviceMiniportCreate angegeben hat.
Beispiele
Im folgenden Codebeispiel wird ein Handle für das Framework-Geräteobjekt abgerufen, das einem WDM-Geräteobjekt zugeordnet ist, das vom aufrufenden Treiber erstellt wurde.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |