Partilhar via

Trabalhar com interfaces USB

A estrutura representa cada interface USB como um objeto de interface USB do framework . Quando um driver cria um objeto de dispositivo USB do framework, o framework cria um objeto de interface USB do framework para cada interface USB que a primeira configuração USB do dispositivo contém.

A maioria dos dispositivos USB tem apenas uma interface, e a interface tem apenas uma configuração alternativa. Os drivers para esses dispositivos normalmente não precisam usar os métodos de objeto que o objeto de interface USB da estrutura define.

Se o driver suportar dispositivos USB que fornecem várias interfaces ou configurações alternativas, os métodos de objeto de interface permitem que o driver execute as seguintes operações:

Obtenção de informações sobre a interface

Após o driver chamar WdfUsbTargetDeviceCreateWithParameters, ele poderá chamar WdfUsbTargetDeviceGetInterface para obter um identificador para um objeto de interface USB na framework que representa uma das interfaces USB do dispositivo. Em seguida, o driver pode chamar vários métodos que o objeto de interface USB define para obter informações sobre a interface USB.

Seu driver pode chamar os seguintes métodos a qualquer momento depois de ter chamado WdfUsbTargetDeviceCreateWithParameters:

WdfUsbInterfaceGetInterfaceNumber
Retorna o número da interface USB associado a um objeto de interface USB.

WdfUsbInterfaceGetDescriptor
Recupera o descritor de interface USB associado a uma das configurações alternativas de uma interface USB.

WdfUsbInterfaceGetNumEndpoints
Retorna o número de terminais associados a uma das definições alternativas de uma interface USB.

WdfUsbInterfaceGetEndpointInformation
Recupera informações sobre um ponto de extremidade e o seu canal associado.

Seu driver pode chamar os seguintes métodos depois de ter chamado WdfUsbTargetDeviceSelectConfig:

WdfUsbInterfaceGetConfiguredSettingIndex
Retorna um valor de índice que identifica a configuração alternativa atualmente selecionada para uma interface USB.

WdfUsbInterfaceGetNumConfiguredPipes
Retorna o número de tubos configurados para uma interface de dispositivo USB especificada.

WdfUsbInterfaceGetConfiguredPipe
Retorna um identificador para o objeto de canalização do framework que está associado a uma interface de dispositivo USB especificada e índice de canalização.

Selecionando uma configuração alternativa para uma interface USB

Depois que um driver chamou WdfUsbTargetDeviceCreateWithParameters, o driver pode chamar WdfUsbInterfaceGetNumSettings para obter o número de configurações alternativas suportadas por uma interface USB.

Depois que um driver chamou WdfUsbTargetDeviceSelectConfig para selecionar uma configuração para um dispositivo USB, o driver pode chamar WdfUsbInterfaceSelectSetting para selecionar uma configuração alternativa para uma das interfaces USB da configuração.

As configurações alternativas do dispositivo devem ser numeradas contíguas, começando com zero.

Para obter informações relacionadas, consulte Como selecionar uma configuração alternativa em uma interface USB.

  • Last updated on