Fungsi WdfWdmDeviceGetWdfDeviceHandle (wdfdevice.h)
[Berlaku untuk KMDF saja]
Metode WdfWdmDeviceGetWdfDeviceHandle mengembalikan handel ke objek perangkat kerangka kerja yang terkait dengan objek perangkat WDM tertentu.
Sintaks
WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Penunjuk ke struktur DEVICE_OBJECT WDM yang dibuat driver panggilan.
Nilai kembali
Jika objek perangkat WDM yang ditentukan valid, WdfWdmDeviceGetWdfDeviceHandle mengembalikan handel ke objek perangkat kerangka kerja terkait. Jika tidak, metode mengembalikan NULL.
Keterangan
Struktur DEVICE_OBJECT WDM yang ditentukan driver untuk parameter DeviceObject harus mewakili objek perangkat yang dibuat driver panggilan. Misalnya, struktur tidak dapat mewakili salah satu objek perangkat WDM yang ditentukan driver dalam panggilan sebelumnya ke WdfDeviceMiniportCreate.
Contoh
Contoh kode berikut mendapatkan handel ke objek perangkat kerangka kerja yang terkait dengan objek perangkat WDM yang dibuat driver panggilan.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
| IRQL | <=DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |