Share via

Função XInputGetCapabilities (xinput.h)

  • Artigo

Recupera os recursos e os recursos de um controlador conectado.

Sintaxe

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

Parâmetros

[in] dwUserIndex

Índice do controlador do usuário. Pode ser um valor no intervalo de 0 a 3. Para obter informações sobre como esse valor é determinado e como o valor é mapeado para indicadores no controlador, consulte Vários controladores.

[in] dwFlags

Sinalizadores de entrada que identificam o tipo de controlador. Se esse valor for 0, os recursos de todos os controladores conectados ao sistema serão retornados. Atualmente, há suporte para apenas um valor:

Valor Descrição
XINPUT_FLAG_GAMEPAD Limitar a consulta a dispositivos do tipo de controlador.
 

Qualquer valor de dwflags diferente do acima ou 0 é ilegal e resultará em uma quebra de erro ao depurar.

[out] pCapabilities

Ponteiro para uma estrutura XINPUT_CAPABILITIES que recebe os recursos do controlador.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se o controlador não estiver conectado, o valor retornado será ERROR_DEVICE_NOT_CONNECTED.

Se a função falhar, o valor retornado será um código de erro definido em WinError.h. A função não usa SetLastError para definir o código de último erro do thread de chamada.

Comentários

Nota A versão herdada do XINPUT 9.1.0 (incluída no Windows Vista e posterior) sempre retornava um conjunto fixo de recursos, independentemente do dispositivo anexado.
 

Requisitos da plataforma

Windows 8 (XInput 1.4), SDK do DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)

Requisitos

   
Plataforma de Destino Windows
Cabeçalho xinput.h
Biblioteca Xinput.lib; Xinput9_1_0.lib
DLL Xinput1_4.dll; Xinput9_1_0.dll

Confira também

Funções XInput

XInputGetState

XInputSetState