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)

Lihat juga

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget