Fungsi UdecxWdfDeviceAddUsbDeviceEmulation (udecxwdfdevice.h)

  • Artikel

Menginisialisasi objek perangkat kerangka kerja untuk mendukung operasi yang terkait dengan pengontrol host dan perangkat USB virtual yang terpasang pada pengontrol.

Sintaks

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

Parameter

WdfDevice

Handel ke objek perangkat kerangka kerja yang diambil driver klien dalam panggilan sebelumnya ke WdfDeviceCreate.

[in] Config

Penunjuk ke struktur UDECX_WDF_DEVICE_CONFIG yang diinisialisasi driver klien dengan memanggil UDECX_WDF_DEVICE_CONFIG_INIT.

Nilai kembali

Metode mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Driver klien UDE untuk pengontrol host yang ditiru dan perangkat USB harus memanggil metode ini setelah panggilan WdfDeviceCreate .

Selama panggilan ini, implementasi panggilan balik peristiwa yang disediakan driver klien juga terdaftar. Berikan penunjuk fungsi ke fungsi tersebut dengan memanggil pengaturan anggota UDECX_WDF_DEVICE_CONFIG yang sesuai.

Metode ini membuat objek perangkat kerangka kerja mampu melakukan operasi yang terkait dengan pengontrol dan hub akarnya, seperti menangani berbagai antrean yang diperlukan untuk memproses permintaan IOCTL yang dikirim ke perangkat USB yang terpasang.

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