Fungsi WdfDeviceWdmGetDeviceObject (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceWdmGetDeviceObject mengembalikan objek perangkat Windows Driver Model (WDM) yang terkait dengan objek perangkat kerangka kerja tertentu.

Sintaks

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Parameter

Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

WdfDeviceWdmGetDeviceObject mengembalikan pointer ke struktur DEVICE_OBJECT .

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Penunjuk yang dikembalikan metode WdfDeviceWdmGetDeviceObject valid hingga objek perangkat kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek perangkat kerangka kerja, penunjuk valid hingga fungsi panggilan balik kembali.

Contoh

Contoh kode berikut membuat pesan pelacakan yang berisi pointer ke objek perangkat WDM yang mewakili PDO dan FDO perangkat.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

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

WdfDeviceWdmGetPhysicalDevice