estrutura XINPUT_CAPABILITIES (xinput.h)

  • Artigo

Descreve os recursos de um controlador conectado. A função XInputGetCapabilities retorna XINPUT_CAPABILITIES.

Sintaxe

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

Membros

Type

Tipo de controlador. Deve ser um dos valores a seguir.

Valor Descrição
XINPUT_DEVTYPE_GAMEPAD O dispositivo é um controlador de jogo. 

SubType

Subtipo do controlador de jogo. Consulte Subtipos XINPUT e Controller para obter uma lista de subtipos permitidos.

Nota Para obter restrições sobre o uso desse valor de subtipo, consulte Comentários. Mais subtipos podem ser adicionados no futuro.
 

Flags

Recursos do controlador.

Valor Descrição
XINPUT_CAPS_VOICE_SUPPORTED O dispositivo tem um dispositivo de voz integrado.
XINPUT_CAPS_FFB_SUPPORTED O dispositivo dá suporte à funcionalidade forçar comentários. Observe que esses recursos de force-feedback além do rumble não têm suporte atualmente por meio de XINPUT no Windows.
XINPUT_CAPS_WIRELESS O dispositivo é sem fio.
XINPUT_CAPS_PMD_SUPPORTED O dispositivo dá suporte a módulos de plug-in. Observe que módulos de plug-in como o TID (dispositivo de entrada de texto) não têm suporte atualmente por meio de XINPUT no Windows.
XINPUT_CAPS_NO_NAVIGATION O dispositivo não tem botões de navegação de menu (START, BACK, DPAD).

Gamepad

XINPUT_GAMEPAD estrutura que descreve os recursos do controlador disponíveis e as resoluções de controle.

Vibration

XINPUT_VIBRATION estrutura que descreve a funcionalidade e as resoluções de vibração disponíveis.

Comentários

XInputGetCapabilities retorna XINPUT_CAPABILITIES para indicar as características e a funcionalidade disponível de um controlador especificado.

XInputGetCapabilities define os membros da estrutura para indicar quais entradas o dispositivo dá suporte. Para controles de estado binário, como botões digitais, o bit correspondente reflete se o controle tem ou não suporte do dispositivo. Para controles proporcionais, como thumbsticks, o valor indica a resolução para esse controle. Alguns dos bits menos significativos podem não ser definidos, indicando que o controle não fornece resolução para esse nível.

O membro SubType indica o subtipo específico do controlador presente. Os jogos podem detectar o subtipo do controlador e ajustar sua manipulação de entrada ou saída do controlador com base em subtipos adequados ao gênero de jogo. Por exemplo, um jogo de corrida de carros pode marcar para a presença de um controlador de roda para fornecer um controle mais fino do carro que está sendo conduzido. No entanto, os títulos não devem desabilitar ou ignorar um dispositivo com base em seu subtipo. Subtipos não reconhecidos pelo jogo ou para os quais o jogo não está especificamente ajustado devem ser tratados como um controlador padrão (XINPUT_DEVSUBTYPE_GAMEPAD).

Drivers mais antigos do Windows XUSB relatam informações de funcionalidades incompletas, especialmente para dispositivos sem fio. O driver windows XUSB mais recente fornece suporte total para dispositivos com fio e sem fio e sinalizadores de recursos mais completos e precisos.

Requisitos

Requisito Valor
Cabeçalho xinput.h

Confira também

XINPUT_GAMEPAD

XINPUT_VIBRATION

Estruturas XInput

XInputGetCapabilities