Sintaxe
Parâmetros
info _Out_Tipo: GameInputGamepadInfo* Ponteiro para uma estrutura
GameInputGamepadInfo que recebe as propriedades de gamepad do dispositivo. Se o dispositivo não oferecer suporte à entrada de gamepad, todos os membros da estrutura serão definidos como zero.
Valor retornado
Tipo: booltrue se o dispositivo oferecer suporte à entrada de gamepad e info tiver sido preenchido; caso contrário, false.
Comentários
O métodoGetGamepadInfo copia as propriedades de gamepad do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de gamepad quando o valor retornado por GetSupportedInput inclui GameInputKindGamepad. Se o dispositivo não oferecer suporte à entrada de gamepad, GetGamepadInfo inicializará info com zeros e retornará false.
O membro supportedLayout é uma combinação de sinalizadores GameInputGamepadButtons que identifica quais botões padrão de gamepad o dispositivo tem. Os membros de rótulo descrevem as marcações impressas nos controles correspondentes, como valores GameInputLabel, para que você possa mostrar prompts correspondentes na sua interface do usuário. Os membros extraButtonCount e extraAxisCount relatam quantos botões e eixos de controle o dispositivo tem além do mapeamento padrão de gamepad; use GetExtraButtonIndexes e GetExtraAxisIndexes para localizá-los no estado do controle de uma leitura. O estado do gamepad é lido das leituras por meio de IGameInputReading::GetGamepadState.
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 gamepad de um dispositivo.
gamepadInfo 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 SeriesConfira também
Visão geral do GameInputGameInputGamepadInfo
GetSupportedInput
GameInputKind
GameInputGamepadButtons
GameInputLabel
IGameInputReading::GetGamepadState
IGameInputDevice