Fungsi UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Artikel
07/02/2025

Menunjukkan jenis titik akhir (sederhana atau dinamis) dalam parameter inisialisasi yang digunakan driver klien untuk membuat perangkat USB virtual.

Sintaksis

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Parameter

[in, out] UdecxUsbDeviceInit

Penunjuk ke struktur yang dialokasikan WDF yang berisi parameter inisialisasi untuk perangkat USB virtual. Driver klien mengambil pointer ini dalam panggilan sebelumnya ke UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Nilai UDECX_ENDPOINT_TYPE-type yang menunjukkan jenis titik akhir USB.

Mengembalikan nilai

Tidak

Komentar

Sebelum membuat perangkat USB virtual, driver klien harus menunjukkan jenis titik akhir yang didukungnya. Ini dapat mendukung salah satu dari dua jenis (didefinisikan dalam UDECX_ENDPOINT_TYPE):

Titik akhir sederhana-Driver klien membuat semua objek titik akhir sebelum mencolokkan perangkat. Perangkat hanya boleh memiliki satu konfigurasi dan satu pengaturan antarmuka per antarmuka.
Titik akhir dinamis-Klien membuat objek titik akhir dalam fungsi panggilan balik EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE. Ekstensi kelas emulasi perangkat USB (UdeCx) memanggil implementasi driver ketika mendapatkan permintaan untuk menambahkan atau mengonfigurasi titik akhir.

UdecxUsbDeviceInit adalah struktur buram yang berisi pointer ke fungsi panggilan balik yang terkait dengan titik akhir. Jika driver klien mendukung titik akhir dinamis, maka fungsi panggilan balik ini harus diimplementasikan oleh driver:

Sebelum memanggil metode ini, driver klien harus mengatur pointer tersebut dengan memanggil UdecxUsbDeviceInitSetStateChangeCallbacks.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 10
server minimum yang didukung	Windows Server 2016
Platform Target	Windows
versi KMDF Minimum	1.15
Header	udecxusbdevice.h (termasuk Udecx.h)
Pustaka	Udecxstub.lib
IRQL	PASSIVE_LEVEL