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 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
);
Die 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.
Bemerkungen
Die WDM-DEVICE_OBJECT-Struktur, die der Treiber für den parameter DeviceObject angibt, muss ein Geräteobjekt darstellen, das der aufrufende Treiber erstellt hat. Die Struktur kann beispielsweise keines der WDM-Geräteobjekte darstellen, die der in einem vorherigen Aufruf von WdfDeviceMiniportCreateangegebene Treiber.
Beispiele
Das folgende Codebeispiel ruft ein Handle für das Framework-Geräteobjekt ab, das einem WDM-Geräteobjekt zugeordnet ist, das der aufrufende Treiber erstellt hat.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |