IOCTL_USB_USER_REQUEST IOCTL (usbuser.h)

Artikel
08/26/2023

Permintaan kontrol I/O IOCTL_USB_USER_REQUEST tersedia untuk aplikasi mode pengguna dan driver mode kernel.

IOCTL_USB_USER_REQUEST adalah permintaan kontrol I/O mode pengguna. Permintaan ini menargetkan pengontrol host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).

Penelepon dapat menentukan salah satu kode permintaan berikut:

USBUSER_CLEAR_ROOTPORT_FEATURE: Jangan gunakan permintaan ini.
USBUSER_GET_CONTROLLER_DRIVER_KEY: Melaporkan kunci driver pengontrol host dalam string Unicode yang diketik USB_UNICODE_NAME. Permintaan ini selalu diaktifkan.
USBUSER_GET_CONTROLLER_INFO_0: Mengambil struktur USB_CONTROLLER_INFO_0 yang menjelaskan pengontrol host. Permintaan ini selalu diaktifkan.
USBUSER_GET_ROOTPORT_STATUS: Jangan gunakan permintaan ini.
USBUSER_GET_ROOTHUB_SYMBOLIC_NAME: Melaporkan nama simbolis hub akar dalam string Unicode yang ditik USB_UNICODE_NAME. Permintaan ini selalu diaktifkan.
USBUSER_INVALID_REQUEST: Jangan gunakan permintaan ini.
USBUSER_OP_CLOSE_RAW_DEVICE: Jangan gunakan permintaan ini.
USBUSER_OP_OPEN_RAW_DEVICE: Jangan gunakan permintaan ini.
USBUSER_OP_MASK_DEVONLY_API: Jangan gunakan permintaan ini.
USBUSER_OP_MASK_HCTEST_API: Jangan gunakan permintaan ini.
USBUSER_OP_RAW_RESET_PORT: Jangan gunakan permintaan ini.
USBUSER_OP_SEND_ONE_PACKET: Jangan gunakan permintaan ini.
USBUSER_OP_SEND_RAW_COMMAND: Jangan gunakan permintaan ini.
USBUSER_SET_ROOTPORT_FEATURE: Jangan gunakan permintaan ini.
USBUSER_PASS_THRU: Mengirim perintah khusus vendor yang ditentukan oleh struktur USB_PASS_THRU_PARAMETERS ke driver miniport pengontrol host. Permintaan ini selalu diaktifkan.
USBUSER_GET_BANDWIDTH_INFORMATION: Mengambil struktur USB_BANDWIDTH_INFO yang berisi informasi tentang bandwidth yang dialokasikan. Permintaan ini selalu diaktifkan.
USBUSER_GET_POWER_STATE_MAP: Mengambil struktur USB_POWER_INFO yang berisi informasi tentang status daya pengontrol host dan hub akar. Permintaan ini selalu diaktifkan.
USBUSER_GET_BUS_STATISTICS_0: Mengambil struktur USB_BUS_STATISTICS_0 yang berisi statistik bus. Permintaan ini selalu diaktifkan.
USBUSER_GET_BUS_STATISTICS_0_AND_RESET: Jangan gunakan permintaan ini.
USBUSER_GET_USB_DRIVER_INFORMATION: Mengambil struktur USB_DRIVER_VERSION_PARAMETERS yang menunjukkan versi driver, tumpukan USB, dan antarmuka terkait. Permintaan ini selalu diaktifkan.
USBUSER_GET_USB2_HW_VERSION: Jangan gunakan permintaan ini.

Buffer input

Buffer di Irp-AssociatedIrp.SystemBuffer> berisi struktur header permintaan pengguna (USBUSER_REQUEST_HEADER) yang menentukan permintaan. Mengikuti struktur header adalah struktur yang menyimpan parameter permintaan. Untuk informasi selengkapnya tentang struktur parameter yang sesuai dengan setiap permintaan, lihat deskripsi setiap permintaan.

Panjang buffer input

Ukuran struktur USBUSER_REQUEST_HEADER .

Buffer output

Struktur parameter segera mengikuti struktur USBUSER_REQUEST_HEADER di Irp-AssociatedIrp.SystemBuffer>. Untuk beberapa permintaan pengguna, struktur parameter akan berisi data output saat permintaan selesai.