Pular para o conteúdo principal
Recupera as propriedades de arcade stick do dispositivo, como os rótulos dos botões e das direções da alavanca.

Sintaxe

Parâmetros

info   _Out_
Tipo: GameInputArcadeStickInfo*
Ponteiro para uma estrutura GameInputArcadeStickInfo que recebe as propriedades de arcade stick do dispositivo. Se o dispositivo não oferecer suporte à entrada de arcade stick, todos os membros da estrutura serão definidos como zero.

Valor retornado

Tipo: bool true se o dispositivo oferecer suporte à entrada de arcade stick e info tiver sido preenchido; caso contrário, false.

Comentários

O método GetArcadeStickInfo copia as propriedades de arcade stick do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de arcade stick quando o valor retornado por GetSupportedInput inclui GameInputKindArcadeStick. Se o dispositivo não oferecer suporte à entrada de arcade stick, GetArcadeStickInfo inicializará info com zeros e retornará false. Os membros de rótulo descrevem as marcações impressas nos controles correspondentes, como valores de GameInputLabel, para que você possa mostrar prompts correspondentes na interface do usuário. Os membros extraButtonCount e extraAxisCount informam quantos botões e eixos de controle o dispositivo tem além do mapeamento padrão de arcade stick; use GetExtraButtonIndexes e GetExtraAxisIndexes para localizá-los no estado do controle de uma leitura. O estado do arcade stick é lido a partir das leituras usando IGameInputReading::GetArcadeStickState. As propriedades retornadas por este método são fixas durante o tempo de vida do dispositivo, portanto você pode consultá-las uma vez (por exemplo, quando o dispositivo se conecta) e armazenar o resultado em cache. O exemplo a seguir mostra como consultar as propriedades de arcade stick de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro arcadeStickInfo da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
GameInputArcadeStickInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetArcadeStickState
IGameInputDevice

Histórico de versões

Última modificação em 6 de novembro de 2026