Fungsi WdfIoTargetGetDevice (wdfiotarget.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfIoTargetGetDevice mengembalikan handel ke objek perangkat kerangka kerja yang merupakan induk dari target I/O lokal atau jarak jauh yang ditentukan.
Sintaks
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
Parameter
[in] IoTarget
Handel ke objek target I/O. Handel ini diperoleh dari WdfDeviceGetIoTarget, WdfIoTargetCreate, atau dari metode yang disediakan target I/O khusus (seperti WdfUsbTargetDeviceGetIoTarget).
Nilai kembali
WdfIoTargetGetDevice mengembalikan handel ke objek perangkat kerangka kerja.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Untuk informasi selengkapnya tentang WdfIoTargetGetDevice, lihat Mendapatkan Informasi Tentang Target I/O Umum.
Untuk informasi selengkapnya tentang target I/O, lihat Menggunakan Target I/O.
Contoh
Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik EvtIoTargetQueryRemove dapat memanggil WdfIoTargetGetDevice.
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Versi UMDF minimum | 2.0 |
Header | wdfiotarget.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |