IOCTL_USB_USER_REQUEST IOCTL (usbuser.h)

Artigo
08/26/2023

A solicitação de controle de E/S IOCTL_USB_USER_REQUEST está disponível para aplicativos de modo de usuário e drivers de modo kernel.

IOCTL_USB_USER_REQUEST é uma solicitação de controle de E/S no modo de usuário. Essa solicitação tem como destino o controlador de host USB (GUID_DEVINTERFACE_USB_HOST_CONTROLLER).

Os chamadores podem especificar qualquer um dos seguintes códigos de solicitação:

USBUSER_CLEAR_ROOTPORT_FEATURE: Não use esta solicitação.
USBUSER_GET_CONTROLLER_DRIVER_KEY: Relata a chave do driver do controlador de host em uma cadeia de caracteres Unicode tipo USB_UNICODE_NAME. Essa solicitação está sempre habilitada.
USBUSER_GET_CONTROLLER_INFO_0: Recupera uma estrutura USB_CONTROLLER_INFO_0 que descreve o controlador de host. Essa solicitação está sempre habilitada.
USBUSER_GET_ROOTPORT_STATUS: Não use esta solicitação.
USBUSER_GET_ROOTHUB_SYMBOLIC_NAME: Relata o nome simbólico do hub raiz em uma cadeia de caracteres Unicode tipo USB_UNICODE_NAME. Essa solicitação está sempre habilitada.
USBUSER_INVALID_REQUEST: Não use esta solicitação.
USBUSER_OP_CLOSE_RAW_DEVICE: Não use esta solicitação.
USBUSER_OP_OPEN_RAW_DEVICE: Não use esta solicitação.
USBUSER_OP_MASK_DEVONLY_API: Não use esta solicitação.
USBUSER_OP_MASK_HCTEST_API: Não use esta solicitação.
USBUSER_OP_RAW_RESET_PORT: Não use esta solicitação.
USBUSER_OP_SEND_ONE_PACKET: Não use esta solicitação.
USBUSER_OP_SEND_RAW_COMMAND: Não use esta solicitação.
USBUSER_SET_ROOTPORT_FEATURE: Não use esta solicitação.
USBUSER_PASS_THRU: Envia um comando específico do fornecedor que é definido pela estrutura USB_PASS_THRU_PARAMETERS para o driver de miniporto do controlador de host. Essa solicitação está sempre habilitada.
USBUSER_GET_BANDWIDTH_INFORMATION: Recupera uma estrutura USB_BANDWIDTH_INFO que contém informações sobre a largura de banda alocada. Essa solicitação está sempre habilitada.
USBUSER_GET_POWER_STATE_MAP: Recupera uma estrutura USB_POWER_INFO que contém informações sobre o estado de energia do controlador de host e dos hubs raiz. Essa solicitação está sempre habilitada.
USBUSER_GET_BUS_STATISTICS_0: Recupera uma estrutura USB_BUS_STATISTICS_0 que contém estatísticas de barramento. Essa solicitação está sempre habilitada.
USBUSER_GET_BUS_STATISTICS_0_AND_RESET: Não use esta solicitação.
USBUSER_GET_USB_DRIVER_INFORMATION: Recupera uma estrutura USB_DRIVER_VERSION_PARAMETERS que indica a versão do driver, da pilha USB e das interfaces associadas. Essa solicitação está sempre habilitada.
USBUSER_GET_USB2_HW_VERSION: Não use esta solicitação.

Buffer de entrada

O buffer em Irp-AssociatedIrp.SystemBuffer> contém uma estrutura de cabeçalho de solicitação do usuário (USBUSER_REQUEST_HEADER) que define a solicitação. Seguindo a estrutura de cabeçalho está uma estrutura que contém os parâmetros da solicitação. Para obter mais informações sobre as estruturas de parâmetro que correspondem a cada solicitação, consulte a descrição de cada solicitação.

Comprimento do buffer de entrada

O tamanho de uma estrutura USBUSER_REQUEST_HEADER .

Buffer de saída

Uma estrutura de parâmetros segue imediatamente a estrutura USBUSER_REQUEST_HEADER em Irp-AssociatedIrp.SystemBuffer>. Para algumas solicitações de usuário, a estrutura de parâmetros conterá dados de saída quando a solicitação for concluída.