IOCTL_INTERNAL_USBFN_GET_INTERFACE_DESCRIPTOR_SET IOCTL (usbfnioctl.h)

  • Artikel

Driver kelas mengirimkan permintaan ini untuk mengatur seluruh deskriptor antarmuka USB untuk fungsi pada perangkat.

Catatan Jangan gunakan permintaan ini untuk mengambil deskriptor antarmuka yang ditetapkan untuk seluruh perangkat.
 

Kode utama

IRP_MJ_INTERNAL_DEVICE_CONTROL

Buffer input

Penunjuk ke buffer yang berisi struktur USBFN_INTERFACE_INFO .

Panjang buffer input

Panjang buffer input harus setidaknya sizeof(USBFN_INTERFACE_INFO).

Buffer output

Penunjuk ke buffer yang berisi struktur USBFN_INTERFACE_INFO . Ekstensi kelas fungsi USB (UFX) mengisi struktur dengan seluruh deskriptor antarmuka yang ditetapkan termasuk deskriptor titik akhirnya.

Panjang buffer output

Panjang buffer output harus setidaknya sizeof(USBFN_INTERFACE_INFO).

Blok status

Jika permintaan berhasil, ekstensi kelas fungsi USB (UFX) mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, ia mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.

Keterangan

Permintaan ini harus dikirim setelah mengirim permintaan IOCTL_INTERNAL_USBFN_ACTIVATE_USB_BUS .

Panjang seluruh deskriptor antarmuka bervariasi. Driver kelas mungkin perlu mengirim permintaan IOCTL ini dua kali untuk mendapatkan seluruh set deskriptor.

Jika panjang seluruh set deskriptor lebih besar dari panjang buffer output yang ditentukan, UFX mengatur anggota UkuranUSBFN_INTERFACE_INFO ke panjang buffer aktual dan gagal permintaan dengan STATUS_BUFFER_TOO_SMALL. Driver kemudian harus mengalokasikan buffer output dengan panjang yang ditentukan oleh Ukuran dan mengirim ulang permintaan.

Persyaratan

Persyaratan Nilai
Header usbfnioctl.h

Lihat juga

IOCTL_INTERNAL_USBFN_ACTIVATE_USB_BUS

USBFN_INTERFACE_INFO