Função XInputGetCapabilities (xinput.h)
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
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 |