Pular para o conteúdo principal
Recupera as propriedades de flight stick do dispositivo, como os rótulos dos botões, da chave hat e dos eixos.

Sintaxe

Parâmetros

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

Valor retornado

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

Comentários

O método GetFlightStickInfo copia as propriedades de flight stick do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de flight stick quando o valor retornado por GetSupportedInput inclui GameInputKindFlightStick. Se o dispositivo não oferecer suporte à entrada de flight stick, GetFlightStickInfo 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 flight stick; use GetExtraButtonIndexes e GetExtraAxisIndexes para localizá-los no estado do controle de uma leitura. O estado do flight stick é lido a partir das leituras usando IGameInputReading::GetFlightStickState. 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 flight stick de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro flightStickInfo 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
GameInputFlightStickInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetFlightStickState
IGameInputDevice

Histórico de versões

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