Fungsi UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

  • Artikel

Mencoba menangani permintaan IOCTL yang dikirim oleh perangkat lunak mode pengguna.

Sintaks

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

Parameter

UdecxWdfDevice

Handel ke objek perangkat kerangka kerja yang mewakili pengontrol. Driver klien menginisialisasi objek ini dalam panggilan sebelumnya ke UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Handel ke objek permintaan kerangka kerja yang mewakili permintaan IOCTL.

Nilai kembali

TRUE menunjukkan bahwa ekstensi kelas emulasi perangkat USB (UdeCx) mengenali dan menyelesaikan permintaan (dengan keberhasilan atau kegagalan). Dalam hal ini, driver klien tidak boleh menyelesaikan permintaan. FALSE jika tidak; driver harus menyelesaikan permintaan.

Keterangan

Driver klien UDE menyajikan dirinya sendiri ke perangkat lunak mode pengguna sebagai driver pengontrol host. Driver klien mendaftar dan mengekspos GUID antarmuka perangkat GUID_DEVINTERFACE_USB_HOST_CONTROLLER. Perangkat lunak mode pengguna dapat membuka handel ke perangkat dengan menentukan GUID tersebut. Dengan menggunakan handel tersebut, perangkat lunak dapat mengirim permintaan IOCTL.

Catatan Perhatikan bahwa kode IOCTL antarmuka lain mungkin tumpang tindih dengan antarmuka pengontrol host USB. Jika I/O tersebut mencapai fungsi ini, IOCTL tidak akan ditangani dengan benar.
 
Driver klien tidak perlu memproses IOCTL yang diterima. Ini dapat mengirim permintaan ke ekstensi kelas dengan memanggil UdecxWdfDeviceTryHandleUserIoctl. Jika ekstensi kelas mengenali permintaan sebagai permintaan standar, ekstensi tersebut akan menyelesaikannya. Jika tidak, panggilan gagal dan driver klien kemudian diharapkan untuk menyelesaikan permintaan. Untuk daftar IOCTL yang harus ditangani, lihat IOCTL USB untuk aplikasi dan layanan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Versi KMDF minimum 1.15
Header udecxwdfdevice.h (termasuk Udecx.h)
Pustaka Udecxstub.lib
IRQL PASSIVE_LEVEL

Lihat juga

Arsitektur: Emulasi Perangkat USB (UDE)

Menulis driver klien UDE