IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS IOCTL (usbioctl.h)

Artikel
02/27/2024

Driver klien mengirimkan permintaan ini untuk mengambil karakteristik transportasi.

Kode utama

Buffer Input/Output

Anggota AssociatedIrp.SystemBuffer adalah penunjuk ke struktur USB_TRANSPORT_CHARACTERISTICS yang dialokasikan pemanggil. Pada input, atur Versi ke USB_TRANSPORT_CHARACTERISTICS_VERSION_1. Pada Versi output diatur ulang ke versi yang kurang dari atau sama dengan USB_TRANSPORT_CHARACTERISTICS_VERSION_1; dia anggota struktur yang tersisa diisi dengan informasi transportasi.

Panjang buffer Input/Output

Ukuran struktur USB_TRANSPORT_CHARACTERISTICS .

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, Status ke kondisi kesalahan yang sesuai sebagai kode NTSTATUS .

Keterangan

Permintaan ini mengambil karakteristik transportasi untuk memutuskan algoritma untuk streaming. Misalnya, driver tampilan dapat menggunakan informasi latensi dan bandwidth untuk memutuskan pemilihan codec-nya.

Informasi ini mungkin tidak selalu tersedia. Tumpukan driver USB tergantung pada transportasi yang mendasar untuk mengekspos nilai-nilai ini. Oleh karena itu, driver klien harus memiliki mekanisme pencadangan untuk kasus seperti itu di mana permintaan.

Jika driver klien tertarik untuk mengetahui informasi terbaru setiap saat, driver harus mendaftar untuk pemberitahuan ketika karakteristik transportasi berubah, menjaga permintaan tertunda dengan tumpukan driver USB, dan membatalkan pendaftaran ketika pemberitahuan tidak lagi diperlukan. Driver dapat menyelesaikan semua tugas tersebut dengan mengirim permintaan IOCTL ini.