Fungsi WdfIoTargetWdmGetTargetPhysicalDevice (wdfiotarget.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfIoTargetWdmGetTargetPhysicalDevice mengembalikan penunjuk ke objek perangkat fisik (PDO) Windows Driver Model (WDM) yang mewakili perangkat target I/O jarak jauh.

Sintaks

PDEVICE_OBJECT WdfIoTargetWdmGetTargetPhysicalDevice(
  [in] WDFIOTARGET IoTarget
);

Parameter

[in] IoTarget

Handel ke objek target I/O jarak jauh. Handel ini diperoleh dari panggilan sebelumnya ke WdfIoTargetCreate.

Nilai kembali

Jika target I/O mewakili perangkat PnP, WdfIoTargetWdmGetTargetPhysicalDevice mengembalikan pointer ke struktur DEVICE_OBJECT yang mewakili PDO target I/O jarak jauh. Jika tidak, metode mengembalikan NULL.

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

Keterangan

Penunjuk yang dikembalikan metode WdfIoTargetWdmGetTargetPhysicalDevice valid hingga driver memanggil WdfIoTargetClose atau WdfIoTargetCloseForQueryRemove, atau sampai objek target I/O jarak jauh dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek target I/O jarak jauh, dan jika objek dihapus sebelum target I/O jarak jauh ditutup, penunjuk valid hingga fungsi EvtCleanupCallback kembali.

Jika driver mencoba mengakses objek perangkat WDM setelah dihapus, driver dapat menyebabkan sistem mengalami crash. Sampel toastmon menunjukkan bagaimana driver dapat menyediakan fungsi panggilan balik EvtIoTargetQueryRemove sehingga diberi tahu jika target I/O dihapus.

Untuk informasi selengkapnya tentang WdfIoTargetWdmGetTargetPhysicalDevice, lihat Mendapatkan Informasi Tentang Target I/O Umum.

Untuk informasi selengkapnya tentang target I/O, lihat Menggunakan Target I/O.

Contoh

Contoh kode berikut mendapatkan penunjuk ke struktur DEVICE_OBJECT yang mewakili PDO perangkat target I/O jarak jauh.

PDEVICE_OBJECT  pTargetDO;

pTargetDO = WdfIoTargetWdmGetTargetPhysicalDevice(IoTarget);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfiotarget.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

DEVICE_OBJECT

WdfIoTargetCreate