Pular para o conteúdo principal
Recupera informações sobre as chaves de controle genérico, como chaves hat e direcionais (D-pads), no dispositivo.

Sintaxe

Parâmetros

infoArrayCount   _In_
Tipo: uint32_t
Número de elementos em infoArray. Para recuperar todas as chaves de controle, passe o valor retornado por GetControllerSwitchCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputControllerSwitchInfo*
Ponteiro para uma matriz que recebe uma estrutura por chave de controle. Pode ser nullptr; nesse caso, nada é gravado e o método retorna 0.

Valor retornado

Tipo: uint32_t O número de elementos gravados em infoArray. Esse é o menor valor entre infoArrayCount e o número de chaves de controle no dispositivo, ou 0 se infoArray for nullptr ou se o dispositivo não tiver chaves de controle.

Comentários

Cada elemento é uma estrutura GameInputControllerSwitchInfo que descreve o tipo da chave correspondente (de 2, 4 ou 8 posições, como um valor de GameInputSwitchKind) e o rótulo de cada uma de suas posições. Chame GetControllerSwitchCount para obter o número de chaves de controle, aloque uma matriz desse tamanho e, em seguida, chame GetControllerSwitchInfo para preenchê-la. Se infoArrayCount for menor que o número de chaves de controle, somente os primeiros infoArrayCount elementos serão gravados. As chaves de controle de um dispositivo não mudam enquanto o dispositivo está conectado, portanto você pode consultá-las uma vez e armazenar o resultado em cache. O elemento i da matriz de informações descreve a chave no índice i da matriz retornada por IGameInputReading::GetControllerSwitchState para leituras desse dispositivo. O exemplo a seguir mostra como recuperar as chaves de controle de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro controllerSwitchInfo da estrutura GameInputControllerInfo, referenciada pelo membro controllerInfo 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
GetControllerSwitchCount
GameInputControllerSwitchInfo
GameInputSwitchKind
IGameInputReading::GetControllerSwitchState
IGameInputDevice

Histórico de versões

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