IOCTL_USB_USER_REQUEST IOCTL (usbuser.h)
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.
Comprimento do buffer de saída
O comprimento da estrutura de parâmetros.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | usbuser.h (include Usbuser.h) |