Fungsi WdfDeviceGetIoTarget (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceGetIoTarget mengembalikan handel ke fungsi atau memfilter target I/O lokal driver, untuk perangkat tertentu.

Sintaks

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

Nilai kembali

Jika operasi berhasil, WdfDeviceGetIoTarget mengembalikan handel ke objek target I/O kerangka kerja. Jika objek perangkat kerangka kerja yang ditentukan mewakili PDO, metode mengembalikan NULL.

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

Keterangan

Ketika driver UMDF mengirim permintaan yang dibuat driver ke target I/O lokal, permintaan tidak memiliki objek file terkait. Beberapa target yang lebih rendah, seperti PDO mentah yang dijumlahkan HIDClass, permintaan gagal yang tidak memiliki objek file terkait. Dalam situasi ini, driver UMDF dapat menentukan WdfIoTargetOpenLocalTargetByFile untuk membuat target I/O yang mewakili tumpukan yang lebih rendah (sama seperti target lokal) menggunakan handel file. Akibatnya, setiap permintaan yang dibuat driver yang dikirim ke target I/O ini dikaitkan dengan objek file yang sesuai dengan handel yang dibuka.

Untuk melakukannya, panggil fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE sebelum memanggil WdfIoTargetOpen.

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

Contoh

Contoh kode berikut mendapatkan handel ke target I/O lokal perangkat tertentu.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Persyaratan

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