Bagikan melalui


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)

Lihat juga

WdfDeviceMiniportCreate