Fungsi WdfIoTargetWdmGetTargetPhysicalDevice (wdfiotarget.h)
[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) |