Fungsi WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfFdoInitWdmGetPhysicalDevice mengambil objek perangkat fisik WDM (PDO) perangkat.

Sintaks

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT yang diperoleh driver dari fungsi panggilan balik EvtDriverDeviceAdd .

Nilai kembali

Jika operasi berhasil, metode mengembalikan penunjuk ke struktur DEVICE_OBJECT . Jika tidak, metode mengembalikan NULL.

Keterangan

Driver harus memanggil WdfFdoInitWdmGetPhysicalDevice sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.

Untuk informasi selengkapnya tentang metode WdfFdoInitWdmGetPhysicalDevice , lihat Membuat Objek Perangkat di Driver Fungsi.

Contoh

Contoh kode berikut mendapatkan penunjuk ke struktur DEVICE_OBJECT yang mewakili PDO WDM perangkat.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdffdo.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)