IOCTL_GENERICUSBFN_GET_INTERFACE_DESCRIPTOR_SET IOCTL (genericusbfnioctl.h)
Kode kontrol I/O (IOCTL) ini dikirim oleh layanan atau aplikasi mode pengguna untuk mengatur seluruh deskriptor antarmuka Universal Serial Bus (USB) untuk fungsi pada perangkat.
Buffer input
Penunjuk ke struktur USBFN_INTERFACE_INFO .
Panjang buffer input
Ukuran struktur 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 diatur termasuk deskriptor titik akhirnya.
Panjang buffer output
Ukuran USBFN_INTERFACE_INFO.
Keterangan
Permintaan ini harus dikirim setelah mengirim permintaan IOCTL_GENERICUSBFN_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.
Jika kode kontrol I/O (IOCTL) ini dipanggil secara sinkron, atur parameter lpOverlapped ke NULL. Jika IOCTL ini dipanggil secara asinkron, tetapkan parameter lpOverlapped ke penunjuk ke struktur TUMPANG TINDIH yang berisi handel ke objek peristiwa. Objek peristiwa memberi sinyal ketika operasi selesai.
Nilai yang dikembalikan adalah nilai BOOL yang menunjukkan keberhasilan atau kegagalan operasi. TRUE menunjukkan keberhasilan, FALSE jika tidak.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | genericusbfnioctl.h (termasuk GenericUsbFnIoctl.h) |