XINPUT_CAPABILITIES

Descreve as funcionalidades de um controle conectado.

Sintaxe

typedef struct XINPUT_CAPABILITIES {  
    BYTE Type;  
    BYTE SubType;  
    WORD Flags;  
    XINPUT_GAMEPAD Gamepad;  
    XINPUT_VIBRATION Vibration;  
} XINPUT_CAPABILITIES  

Membros

Type
Tipo: BYTE Tipo de controle. Deve ser do tipo XINPUT_DEVTYPE_GAMEPAD e ter um dos valores listados na tabela abaixo. SubType
Tipo: BYTE Subtipo do controle de jogo. Subtipos permitidos:

Subtipo	Significado
XINPUT_DEVSUBTYPE_UNKNOWN	Desconhecido. O tipo de controle é desconhecido.
XINPUT_DEVSUBTYPE_GAMEPAD	Controle gamepad. Inclui os direcionais analógicos esquerdo e direito, os gatilhos esquerdo e direito, o direcional digital e todos os botões padrão: A, B, X, Y, START, BACK, LB, RB, LSB e RSB.
XINPUT_DEVSUBTYPE_WHEEL	Controle de volante de corrida. O eixo X do direcional analógico esquerdo relata a rotação do volante, o gatilho direito é o pedal do acelerador e o gatilho esquerdo é o pedal do freio. O direcional digital e a maioria dos botões padrão estão incluídos: A, B, X, Y, START, BACK, LB e RB. LSB e RSB são opcionais.
XINPUT_DEVSUBTYPE_ARCADE_STICK	Controle de arcade stick. Inclui um direcional digital que é relatado como DPAD (para cima, para baixo, para a esquerda e para a direita) e a maioria dos botões padrão: A, B, X, Y, START e BACK. Os gatilhos esquerdo e direito são implementados como botões digitais e relatam 0 ou 0xFF. LB, LSB, RB e RSB são opcionais.
XINPUT_DEVSUBTYPE_FLIGHT_STICK	Controle de flight stick. Inclui um manche de arfagem e rolagem que é relatado como o direcional analógico esquerdo, um POV Hat que é relatado como o direcional analógico direito, um leme (torção da alça ou balancim) que é relatado como o gatilho esquerdo e um controle de aceleração como o gatilho direito. Inclui suporte para uma arma primária (A), uma arma secundária (B) e outros botões padrão: X, Y, START e BACK. LB, LSB, RB e RSB são opcionais.
XINPUT_DEVSUBTYPE_DANCE_PAD	Controle de tapete de dança. Inclui o direcional digital e os botões padrão (A, B, X e Y) no tapete, além de BACK e START.
XINPUT_DEVSUBTYPE_GUITAR XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE XINPUT_DEVSUBTYPE_GUITAR_BASS	Controle de guitarra. A barra de palhetada é mapeada para o DPAD (para cima e para baixo), e os trastes são atribuídos a A (verde), B (vermelho), Y (amarelo), X (azul) e LB (laranja). O eixo Y do direcional analógico direito está associado a um sensor de orientação vertical, e o eixo X do direcional analógico direito é a alavanca de whammy. Há suporte para BACK, START e DPAD (esquerda, direita). O gatilho esquerdo (seletor de captador), o gatilho direito, RB, LSB (modificador de traste) e RSB são opcionais. Guitar Bass é idêntico a Guitar, com o subtipo distinto para simplificar a configuração. Guitar Alt dá suporte a uma faixa maior de movimento para o sensor de orientação vertical.
XINPUT_DEVSUBTYPE_DRUM_KIT	Controle de bateria. Os pads da bateria são atribuídos a botões: A para verde (Floor Tom), B para vermelho (caixa), X para azul (Low Tom), Y para amarelo (High Tom) e LB para o pedal (bumbo). Direcional digital, BACK e START estão incluídos. RB, LSB e RSB são opcionais.
XINPUT_DEVSUBTYPE_ARCADE_PAD	Controle de arcade pad. Inclui o direcional digital e a maioria dos botões padrão: A, B, X, Y, START, BACK, LB e RB. Os gatilhos esquerdo e direito são implementados como botões digitais e relatam 0 ou 0xFF. Direcional analógico esquerdo, direcional analógico direito, LSB e RSB são opcionais.

Flags
Tipo: WORD Recursos do controle.

Valor	Descrição
XINPUT_CAPS_VOICE_SUPPORTED	O dispositivo tem um dispositivo de voz integrado.
XINPUT_CAPS_FFB_SUPPORTED	O dispositivo dá suporte à funcionalidade de force feedback. No momento, recursos de force feedback além da vibração não têm suporte por meio do XINPUT no Windows.
XINPUT_CAPS_WIRELESS	O dispositivo é sem fio.
XINPUT_CAPS_PMD_SUPPORTED	O dispositivo dá suporte a módulos plug-in. No momento, módulos plug-in (como o dispositivo de entrada de texto (TID)) não têm suporte por meio do XINPUT no Windows.
XINPUT_CAPS_NO_NAVIGATION	O dispositivo não tem os botões de navegação de menu: START, BACK e DPAD.

Gamepad
Tipo: XINPUT_GAMEPAD Estrutura XINPUT_GAMEPAD que descreve os recursos de controle e as resoluções de controle disponíveis. Vibration
Tipo: XINPUT_VIBRATION Estrutura XINPUT_VIBRATION que descreve a funcionalidade de vibração e as resoluções disponíveis.

Comentários

XInputGetCapabilities retorna XINPUT_CAPABILITIES para indicar as características e a funcionalidade disponível de um controle especificado. XInputGetCapabilities define os membros da estrutura para indicar a quais entradas o dispositivo dá suporte. Para controles de estado binário, como botões digitais, o bit correspondente indica se o controle tem suporte no dispositivo. Para controles proporcionais, como direcionais analógicos, o valor indica a resolução desse controle. Alguns dos bits menos significativos podem não estar definidos, para indicar que o controle não fornece resolução até esse nível. O membro SubType indica o subtipo específico do controle presente. Os jogos podem detectar o subtipo do controle e ajustar o tratamento da entrada ou saída do controle de acordo com os subtipos adequados ao gênero do jogo. Por exemplo, um jogo de corrida de carros pode verificar a presença de um controle de volante para fornecer um controle mais preciso do carro que está sendo dirigido. No entanto, os títulos não devem desabilitar nem ignorar um dispositivo de acordo com seu subtipo. Um subtipo não reconhecido pelo jogo, ou para o qual o jogo não foi ajustado especificamente, deve ser tratado como um gamepad padrão, XINPUT_DEVSUBTYPE_GAMEPAD. Os drivers XUSB mais antigos do Windows relatam informações sobre funcionalidades incompletas, especialmente para dispositivos sem fio. O driver XUSB mais recente do Windows oferece suporte completo a dispositivos com fio e sem fio e fornece sinalizadores de funcionalidades mais completos e precisos.

Requisitos

Cabeçalho: XInputOnGameInput.h Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

Portar o XInput para o GameInput
XInputOnGameInput

Porting

Build Paths

XINPUT_CAPABILITIES

XINPUT_CAPABILITIES

Sintaxe

Membros

Comentários

Requisitos

Confira também

​XINPUT_CAPABILITIES

​Sintaxe

​Membros

​Comentários

​Requisitos

​Confira também

XINPUT_CAPABILITIES

Sintaxe

Membros

Comentários

Requisitos

Confira também