Cabeçalho ucxusbdevice.h
Esse cabeçalho é usado para gravar um driver de controlador de host USB. A extensão do controlador de host USB é um driver fornecido pelo sistema (Ucx01000.sys). Esse driver é implementado como uma extensão de classe de estrutura usando as interfaces de programação do Windows Driver Framework. O driver do controlador de host serve como o driver do cliente para essa extensão de classe. Enquanto um driver do controlador de host lida com operações de hardware e eventos, gerenciamento de energia e eventos PnP, o UCX serve como uma interface abstraída que enfileira solicitações para o driver do controlador de host e executa outras tarefas.
Não inclua esse cabeçalho diretamente. Em vez disso, inclua Ucxclass.h
Para obter mais informações, consulte:
- Desenvolvimento de drivers do Windows para controladores de host USB
- Barramento Serial Universal (USB)
ucxusbdevice.h contém as seguintes interfaces de programação:
Funções
| UCX_USBDEVICE_EVENT_CALLBACKS_INIT Inicializa uma estrutura UCX_USBDEVICE_EVENT_CALLBACKS com os ponteiros de função para as funções de retorno de chamada do driver de cliente. |
| UcxUsbDeviceCreate Cria um objeto de dispositivo USB no controlador especificado. |
| UcxUsbDeviceInitSetEventCallbacks Inicializa uma estrutura de UCXUSBDEVICE_INIT com as funções de retorno de chamada de evento do driver cliente. |
| UcxUsbDeviceRemoteWakeNotification Notifica o UCX de que um sinal de ativação remota do dispositivo é recebido. |
Funções de retorno de chamada
| EVT_UCX_USBDEVICE_ADDRESS A implementação do driver cliente que o UCX chama para endereçar o dispositivo USB. |
| EVT_UCX_USBDEVICE_DEFAULT_ENDPOINT_ADD A implementação do driver cliente que o UCX chama para adicionar um novo ponto de extremidade padrão para um dispositivo USB. |
| EVT_UCX_USBDEVICE_DISABLE A implementação do driver cliente que o UCX chama para liberar recursos do controlador associados ao dispositivo e seu ponto de extremidade padrão. |
| EVT_UCX_USBDEVICE_ENABLE A implementação do driver cliente que o UCX chama para programar informações sobre o dispositivo e seu ponto de extremidade de controle padrão no controlador. |
| EVT_UCX_USBDEVICE_ENDPOINT_ADD A implementação do driver cliente que o UCX chama para adicionar um novo ponto de extremidade para um dispositivo USB. |
| EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE A implementação do driver cliente que o UCX chama para configurar pontos de extremidade no controlador. |
| EVT_UCX_USBDEVICE_GET_CHARACTERISTIC O UCX invoca esse retorno de chamada para recuperar as características do dispositivo. |
| EVT_UCX_USBDEVICE_HUB_INFO A implementação do driver cliente que o UCX chama para recuperar as propriedades do hub. |
| EVT_UCX_USBDEVICE_RESET A implementação do driver cliente que o UCX chama quando a porta à qual o dispositivo está anexado é redefinida. |
| EVT_UCX_USBDEVICE_RESUME O UCX invoca essa função de retorno de chamada para retomar um dispositivo do estado de suspensão. |
| EVT_UCX_USBDEVICE_SUSPEND O UCX invoca essa função de retorno de chamada para enviar um estado de suspensão de dispositivo. |
| EVT_UCX_USBDEVICE_UPDATE A implementação do driver cliente que o UCX chama para atualizar as propriedades do dispositivo. |
Estruturas
| ADDRESS0_OWNERSHIP_ACQUIRE Contém parâmetros para configurar o dispositivo. |
| UCX_USBDEVICE_CHARACTERISTIC Armazena as características de um dispositivo. |
| UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY Saiba como UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY armazena os valores de atraso do caminho de transferência isócrono. |
| UCX_USBDEVICE_EVENT_CALLBACKS Essa estrutura fornece uma lista de funções de retorno de chamada de evento de dispositivo USB UCX. |
| UCXUSBDEVICE_INFO Contém informações sobre o dispositivo USB. Essa estrutura é passada pelo UCX na função de retorno de chamada de evento EVT_UCX_CONTROLLER_USBDEVICE_ADD. |
| USB_DEVICE_PORT_PATH Contém o caminho da porta de um dispositivo USB. |
| USBDEVICE_ABORTIO Contém um identificador para o hub ou dispositivo USB (Barramento Serial Universal) para o qual anular transferências de dados. |
| USBDEVICE_ADDRESS Contém parâmetros para uma solicitação para fazer a transição do dispositivo especificado para o estado Endereçado. Essa estrutura é passada pelo UCX em parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura da função de retorno de chamada EVT_UCX_USBDEVICE_ADDRESS. |
| USBDEVICE_DISABLE Contém parâmetros para uma solicitação para desabilitar o dispositivo especificado. Essa estrutura é passada pelo UCX em parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura da função de retorno de chamada EVT_UCX_USBDEVICE_DISABLE. |
| USBDEVICE_ENABLE Contém parâmetros para uma solicitação para habilitar o dispositivo especificado. Essa estrutura é passada pelo UCX em parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura da função de retorno de chamada EVT_UCX_USBDEVICE_ENABLE. |
| USBDEVICE_ENABLE_FAILURE_FLAGS Os sinalizadores definidos pelo driver do cliente na função de retorno de chamada EVT_UCX_USBDEVICE_ENABLE. Indique erros, se houver, que podem ter ocorrido ao habilitar o dispositivo. |
| USBDEVICE_HUB_INFO Contém parâmetros para uma solicitação para obter informações sobre o hub especificado. Essa estrutura é passada pelo UCX em parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura da função de retorno de chamada EVT_UCX_USBDEVICE_HUB_INFO. |
| USBDEVICE_MGMT_HEADER Essa estrutura fornece um identificador para o hub ou dispositivo USB (Barramento Serial Universal) fisicamente conectado ao barramento. |
| USBDEVICE_PURGEIO A estrutura USBDEVICE_PURGEIO contém o identificador do hub ou dispositivo USB (Barramento Serial Universal) para o qual limpar a E/S. |
| USBDEVICE_RESET Contém parâmetros para uma solicitação para redefinir o dispositivo especificado. Essa estrutura é passada pelo UCX em parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura da função de retorno de chamada EVT_UCX_USBDEVICE_RESET. |
| USBDEVICE_STARTIO Contém um identificador para o hub ou dispositivo USB (Barramento Serial Universal) no qual iniciar a transferência de dados. |
| USBDEVICE_TREE_PURGEIO Essa estrutura fornece o identificador da árvore de dispositivos USB (Barramento Serial Universal) para limpar e/S. |
| USBDEVICE_UPDATE Passado pelo UCX para atualizar o dispositivo especificado. Essa estrutura está nos parâmetros de solicitação (Parameters.Others.Arg1) de um objeto de solicitação de estrutura passado na função de retorno de chamada EVT_UCX_USBDEVICE_UPDATE. |
| USBDEVICE_UPDATE_20_HARDWARE_LPM_PARAMETERS Contém parâmetros para uma solicitação para atualizar o LPM (gerenciamento de energia de link) USB 2.0. O UCX passa essa estrutura na função de retorno de chamada EVT_UCX_USBDEVICE_UPDATE. |
| USBDEVICE_UPDATE_FAILURE_FLAGS Os sinalizadores definidos pelo driver do cliente na função de retorno de chamada EVT_UCX_USBDEVICE_UPDATE. Indique erros, se houver, que podem ter ocorrido durante a atualização do dispositivo. |
| USBDEVICE_UPDATE_FLAGS Contém sinalizadores de solicitação definidos pelo UCX que são passados na estrutura USBDEVICE_UPDATE quando o UCX invoca a função de retorno de chamada EVT_UCX_USBDEVICE_UPDATE do driver cliente. |
Enumerações
| UCX_USBDEVICE_CHARACTERISTIC_TYPE Define valores que indicam o tipo de característica do dispositivo. |
| UCX_USBDEVICE_RECOVERY_ACTION Define valores para redefinições de gatilho FLDR e PLDR. |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de