Sintaxe
Parâmetros
labelArrayCount _In_Tipo: uint32_t Número de elementos em labelArray. Para recuperar todos os rótulos de botões de controle, passe o valor retornado por GetControllerButtonCount. labelArray _Out_writes_to_opt_(labelArrayCount, return)
Tipo: GameInputLabel* Ponteiro para uma matriz que recebe um rótulo por botão 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 labelArray. Esse é o menor valor entre labelArrayCount e o número de rótulos de botões de controle no dispositivo, ou 0 se labelArray fornullptr ou se o dispositivo não tiver rótulos de botões de controle.
Comentários
Cada elemento é um valor de GameInputLabel que identifica a marcação impressa no botão correspondente, se o dispositivo relatar uma. Chame GetControllerButtonCount para obter o número de rótulos de botões de controle, aloque uma matriz desse tamanho e, em seguida, chameGetControllerButtonLabels para preenchê-la. Se labelArrayCount for menor que o número de rótulos de botões de controle, somente os primeiros labelArrayCount elementos serão gravados. Os rótulos de botões de controle de um dispositivo não mudam enquanto o dispositivo está conectado, portanto você pode consultá-los uma vez e armazenar o resultado em cache.
O elemento i da matriz de rótulos descreve o botão no índice i da matriz retornada por IGameInputReading::GetControllerButtonState para leituras desse dispositivo.
O exemplo a seguir mostra como recuperar os rótulos de botões de controle de um dispositivo.
controllerButtonLabels 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 SeriesConfira também
Visão geral do GameInputGetControllerButtonCount
GameInputLabel
IGameInputReading::GetControllerButtonState
IGameInputDevice
