Fungsi WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

[Berlaku untuk KMDF saja]

Metode WdfDeviceWdmGetPhysicalDevice mengambil PDO WDM perangkat fisik dari tumpukan perangkat.

Sintaks

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

WdfDeviceWdmGetPhysicalDevice mengembalikan pointer ke struktur DEVICE_OBJECT .

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

WdfDeviceWdmGetPhysicalDevice mengembalikan NULL jika pemanggil menyediakan objek perangkat kontrol.

Keterangan

Penunjuk yang dikembalikan metode WdfDeviceWdmGetPhysicalDevice 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

Untuk contoh kode yang menggunakan WdfDeviceWdmGetPhysicalDevice, lihat WdfDeviceWdmGetAttachedDevice.

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)