IOCTL_USB_USER_REQUEST IOCTL (usbuser.h)

Articolo
08/26/2023

La richiesta di controllo I /O IOCTL_USB_USER_REQUEST è disponibile sia per le applicazioni in modalità utente che per i driver in modalità kernel.

IOCTL_USB_USER_REQUEST è una richiesta di controllo di I/O in modalità utente. Questa richiesta è destinata al controller host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).

I chiamanti possono specificare uno dei codici di richiesta seguenti:

USBUSER_CLEAR_ROOTPORT_FEATURE: Non usare questa richiesta.
USBUSER_GET_CONTROLLER_DRIVER_KEY: Segnala la chiave del driver del controller host in una stringa Unicode tipizzata USB_UNICODE_NAME. Questa richiesta è sempre abilitata.
USBUSER_GET_CONTROLLER_INFO_0: Recupera una struttura USB_CONTROLLER_INFO_0 che descrive il controller host. Questa richiesta è sempre abilitata.
USBUSER_GET_ROOTPORT_STATUS: Non usare questa richiesta.
USBUSER_GET_ROOTHUB_SYMBOLIC_NAME: Segnala il nome simbolico dell'hub radice in una stringa Unicode tipizzata USB_UNICODE_NAME. Questa richiesta è sempre abilitata.
USBUSER_INVALID_REQUEST: Non usare questa richiesta.
USBUSER_OP_CLOSE_RAW_DEVICE: Non usare questa richiesta.
USBUSER_OP_OPEN_RAW_DEVICE: Non usare questa richiesta.
USBUSER_OP_MASK_DEVONLY_API: Non usare questa richiesta.
USBUSER_OP_MASK_HCTEST_API: Non usare questa richiesta.
USBUSER_OP_RAW_RESET_PORT: Non usare questa richiesta.
USBUSER_OP_SEND_ONE_PACKET: Non usare questa richiesta.
USBUSER_OP_SEND_RAW_COMMAND: Non usare questa richiesta.
USBUSER_SET_ROOTPORT_FEATURE: Non usare questa richiesta.
USBUSER_PASS_THRU: Invia un comando specifico del fornitore definito dalla struttura USB_PASS_THRU_PARAMETERS al driver miniport del controller host. Questa richiesta è sempre abilitata.
USBUSER_GET_BANDWIDTH_INFORMATION: Recupera una struttura USB_BANDWIDTH_INFO che contiene informazioni sulla larghezza di banda allocata. Questa richiesta è sempre abilitata.
USBUSER_GET_POWER_STATE_MAP: Recupera una struttura USB_POWER_INFO che contiene informazioni sullo stato di alimentazione del controller host e degli hub radice. Questa richiesta è sempre abilitata.
USBUSER_GET_BUS_STATISTICS_0: Recupera una struttura USB_BUS_STATISTICS_0 che contiene le statistiche del bus. Questa richiesta è sempre abilitata.
USBUSER_GET_BUS_STATISTICS_0_AND_RESET: Non usare questa richiesta.
USBUSER_GET_USB_DRIVER_INFORMATION: Recupera una struttura USB_DRIVER_VERSION_PARAMETERS che indica la versione del driver, dello stack USB e delle interfacce associate. Questa richiesta è sempre abilitata.
USBUSER_GET_USB2_HW_VERSION: Non usare questa richiesta.

Buffer di input

Il buffer in Irp-AssociatedIrp.SystemBuffer> contiene una struttura di intestazione della richiesta utente (USBUSER_REQUEST_HEADER) che definisce la richiesta. Seguendo la struttura dell'intestazione è presente una struttura che contiene i parametri della richiesta. Per altre informazioni sulle strutture dei parametri corrispondenti a ogni richiesta, vedere la descrizione di ogni richiesta.

Lunghezza del buffer di input

Dimensione di una struttura USBUSER_REQUEST_HEADER .

Buffer di output

Una struttura di parametri segue immediatamente la struttura USBUSER_REQUEST_HEADER in Irp-AssociatedIrp.SystemBuffer>. Per alcune richieste utente, la struttura dei parametri conterrà i dati di output al termine della richiesta.