GameInput
As APIs do GameInput são usadas para capturar entradas humanas de uma ampla variedade de dispositivos, como controles de jogo, manches de voo, volantes de corrida e entrada por toque.Esta página documenta a API GameInput atual (mais recente). O histórico de versões de cada membro é indicado nas páginas de referência individuais. Os membros que existiam apenas em versões mais antigas da API estão listados na seção Membros removidos abaixo. Observe que os runtimes mais recentes da API oferecem suporte a todas as versões disponíveis da API, portanto, os membros removidos ainda podem ser usados com os cabeçalhos de versões mais antigas.
Interfaces
| Interface | Descrição |
|---|---|
| IGameInputDevice | Define um dispositivo de entrada. |
| IGameInputDispatcher | Fornece controle manual sobre o agendamento das tarefas em segundo plano gerenciadas pela API GameInput. |
| IGameInputForceFeedbackEffect | Descreve um efeito de force feedback em um dispositivo de entrada compatível. |
| IGameInputMapper | Fornece informações sobre como o GameInput mapeia um dispositivo. |
| IGameInputRawDeviceReport | Representa um buffer de bytes brutos passado para um dispositivo de entrada ou recebido dele. |
| IGameInputReading | Contém os dados de uma única atualização de entrada. |
| IGameInput | Um singleton por processo que fornece acesso ao fluxo de entrada dos dispositivos. |
Funções
| Função | Descrição |
|---|---|
| GameInputCreate | Recupera uma instância da interface IGameInput. |
| GameInputDeviceCallback | Define um retorno de chamada para eventos de conexão e desconexão de dispositivos. |
| GameInputKeyboardLayoutCallback | Define um retorno de chamada para eventos de alteração do layout de teclado. |
| GameInputReadingCallback | Define um retorno de chamada para eventos de chegada de novas leituras. |
| GameInputSystemButtonCallback | Define um retorno de chamada para eventos de pressionamento e liberação do botão Guia ou Compartilhar. |
Estruturas
| Estrutura | Descrição |
|---|---|
| GameInputArcadeStickInfo | Detalha as características de um arcade stick. |
| GameInputArcadeStickState | Fornece o status atual de um arcade stick. |
| GameInputAxisMapping | Descreve como um eixo é mapeado para o controle. |
| GameInputButtonMapping | Descreve como um botão é mapeado para o controle. |
| GameInputControllerInfo | Detalha as características de um controle. |
| GameInputControllerSwitchInfo | Especifica um switch em um dispositivo de entrada. |
| GameInputDeviceInfo | Contém informações abrangentes sobre um dispositivo de entrada. |
| GameInputFlightStickInfo | Detalha as características de um manche de voo. |
| GameInputFlightStickState | Fornece o status atual de um manche de voo. |
| GameInputForceFeedbackConditionParams | Define determinados aspectos físicos de um efeito de force feedback. |
| GameInputForceFeedbackConstantParams | Define um aspecto físico constante de um efeito de force feedback. |
| GameInputForceFeedbackEnvelope | Define um envelope que modifica um efeito de force feedback. |
| GameInputForceFeedbackMagnitude | Define a magnitude da força exercida por um efeito de force feedback. |
| GameInputForceFeedbackMotorInfo | Fornece informações sobre o motor de force feedback. |
| GameInputForceFeedbackParams | Define os atributos com suporte na API de um efeito de force feedback. |
| GameInputForceFeedbackPeriodicParams | Define os parâmetros de um efeito de force feedback periódico. |
| GameInputForceFeedbackRampParams | Define os parâmetros de um efeito de force feedback em rampa. |
| GameInputGamepadInfo | Detalha as características de um gamepad. |
| GameInputGamepadState | Fornece o status atual de um dispositivo de entrada gamepad. |
| GameInputHapticInfo | Detalha as características de um motor de feedback háptico. |
| GameInputKeyState | Fornece o estado atual de uma tecla em um teclado. |
| GameInputKeyboardInfo | Detalha as características de um teclado. |
| GameInputMouseInfo | Detalha as características de um mouse. |
| GameInputMouseState | Fornece o status atual de um mouse. |
| GameInputRacingWheelInfo | Detalha as características de um volante de corrida. |
| GameInputRacingWheelState | Fornece o status atual de um volante de corrida. |
| GameInputRawDeviceReportInfo | Descreve um relatório bruto de dispositivo. |
| GameInputRumbleParams | Descreve um efeito de vibração produzido por um controle. |
| GameInputSensorsInfo | Detalha as características dos sensores disponíveis. |
| GameInputSensorsState | Fornece o status atual dos sensores de um dispositivo. |
| GameInputUsage | Descreve um uso HID específico. |
| GameInputVersion | Descreve um número de versão de quatro partes. |
Enumerações
| Enumeração | Descrição |
|---|---|
| GameInputArcadeStickButtons | Enumera as entradas de um arcade stick. |
| GameInputDeviceFamily | Enumera as famílias de dispositivos de entrada. |
| GameInputDeviceStatus | Enumera os estados em que um dispositivo de entrada pode estar. |
| GameInputElementKind | Enumera o tipo de elemento de uma determinada entrada. |
| GameInputEnumerationKind | Enumera os tipos de comportamento para enumerar dispositivos de entrada. |
| GameInputFeedbackAxes | Enumera os tipos de direção dos motores de force feedback disponíveis em um dispositivo de entrada. |
| GameInputFeedbackEffectState | Enumera os estados de um efeito de force feedback. |
| GameInputFlightStickAxes | Enumera os eixos do manche de voo. |
| GameInputFlightStickButtons | Enumera os botões do manche de voo. |
| GameInputFocusPolicy | Enumera as políticas de foco de um dispositivo de entrada. |
| GameInputForceFeedbackEffectKind | Enumera os tipos de efeitos de magnitude ao longo do tempo que podem ser aplicados a um efeito de force feedback. |
| GameInputGamepadAxes | Enumera os eixos do gamepad. |
| GameInputGamepadButtons | Enumera os botões do gamepad, incluindo o direcional (D-pad). |
| GameInputKeyboardKind | Enumera os tipos de teclado por layout de teclas. |
| GameInputKind | Enumera os tipos de dispositivo válidos do GameInput. |
| GameInputLabel | Enumera os rótulos de botão com suporte. |
| GameInputMouseButtons | Enumera os botões do mouse. |
| GameInputMousePositions | Enumera os modos de posicionamento do mouse. |
| GameInputRacingWheelAxes | Enumera os eixos de um volante de corrida. |
| GameInputRacingWheelButtons | Enumera os botões de um volante de corrida. |
| GameInputRawDeviceReportKind | Enumera os tipos de relatórios brutos de dispositivo. |
| GameInputRumbleMotors | Enumera os motores de vibração com suporte na API para um dispositivo de entrada. |
| GameInputSensorAccuracy | Enumera os níveis de precisão dos sensores. |
| GameInputSensorsKind | Enumera os tipos de sensor válidos do GameInput. |
| GameInputSwitchKind | Enumera os tipos de switches com suporte em um dispositivo de entrada. |
| GameInputSwitchPosition | Enumera as posições de um switch em um dispositivo de entrada. |
| GameInputSystemButtons | Enumera os botões usados para controlar o sistema. |
Membros removidos
Os membros a seguir estavam presentes em versões mais antigas da API, mas foram removidos da API atual. Para obter a documentação completa de cada membro removido, confira Membros preteridos da API GameInput.Interfaces removidas
Nenhuma interface foi removida permanentemente.IGameInputRawDeviceReport esteve ausente nas v1 e v2, mas foi reintroduzida na API atual.
Funções removidas
| Função | Última versão | Descrição |
|---|---|---|
| GameInputGuideButtonCallback | v0 | Retorno de chamada definido pelo título para eventos do botão Guia. Substituída por GameInputSystemButtonCallback. |
Estruturas removidas
| Estrutura | Última versão | Descrição |
|---|---|---|
| GameInputBatteryState | v0 | Descrevia o estado da bateria de um dispositivo de entrada. |
| GameInputControllerAxisInfo | v2 | Descrevia um eixo em um dispositivo de entrada. Substituída por campos em GameInputControllerInfo. |
| GameInputControllerButtonInfo | v2 | Descrevia um botão em um dispositivo de entrada. Substituída por campos em GameInputControllerInfo. |
| GameInputHapticFeedbackMotorInfo | v0 | Descrevia um motor de feedback háptico. Substituída por GameInputHapticInfo. |
| GameInputHapticFeedbackParams | v0 | Descrevia um efeito de feedback háptico. |
| GameInputHapticWaveformInfo | v0 | Descrevia as características de um efeito de feedback háptico. |
| GameInputMotionInfo | v0 | Descrevia as propriedades mensuráveis de um dispositivo de entrada com suporte a movimento. |
| GameInputMotionState | v0 | Descrevia o estado da entrada de movimento. |
| GameInputRawDeviceItemCollectionInfo | v0 | Descrevia uma coleção de itens brutos de dispositivo. |
| GameInputRawDeviceReportItemInfo | v0 | Descrevia um item de relatório bruto de dispositivo. |
| GameInputString | v0 | Descrevia uma cadeia de caracteres que contém informações sobre um dispositivo de entrada. |
| GameInputTouchSensorInfo | v0 | Descrevia um sensor de toque de um dispositivo de entrada. |
| GameInputTouchState | v0 | Descrevia o estado de um dispositivo de entrada por toque. |
| GameInputUiNavigationInfo | v2 | Especificava os rótulos dos botões de navegação na interface do usuário. |
| GameInputUiNavigationState | v2 | Fornecia o status atual da entrada de navegação na interface do usuário. |
Enumerações removidas
| Enumeração | Última versão | Descrição |
|---|---|---|
| GameInputBatteryStatus | v0 | Enumerava os estados da bateria de um dispositivo de entrada. |
| GameInputDeviceCapabilities | v0 | Enumerava determinadas funcionalidades de um dispositivo de entrada. |
| GameInputLocation | v0 | Enumerava as partes de um dispositivo de entrada. |
| GameInputMotionAccuracy | v0 | Enumerava os níveis de precisão dos sensores de movimento. |
| GameInputRawDeviceItemCollectionKind | v0 | Enumerava os tipos de coleções de itens brutos de dispositivo. |
| GameInputRawDevicePhysicalUnitKind | v0 | Enumerava as unidades físicas associadas à entrada do dispositivo. |
| GameInputRawDeviceReportItemFlags | v0 | Enumerava os tipos de itens de relatório bruto de dispositivo. |
| GameInputTouchShape | v0 | Enumerava as formas de um sensor de toque. |
| GameInputUiNavigationButtons | v2 | Enumerava os botões de navegação da interface do usuário. |
Histórico de versões
| Versão | Alterações |
|---|---|
| v3 | Adicionada a interface IGameInputMapper. Reintroduzida a interface IGameInputRawDeviceReport (ausente nas v1/v2). Adicionadas as estruturas GameInputAxisMapping, GameInputButtonMapping, GameInputControllerInfo e GameInputHapticInfo. Reintroduzidas a estrutura GameInputRawDeviceReportInfo e a enumeração GameInputRawDeviceReportKind (ausentes nas v1/v2). Reintroduzida a estrutura GameInputVersion (ausente nas v1/v2). Adicionadas as enumerações GameInputElementKind, GameInputFlightStickAxes, GameInputGamepadAxes e GameInputRacingWheelAxes. Removidas as estruturas GameInputControllerAxisInfo, GameInputControllerButtonInfo, GameInputUiNavigationInfo e GameInputUiNavigationState. Removida a enumeração GameInputUiNavigationButtons. |
| v2 | Adicionadas as estruturas GameInputSensorsInfo e GameInputSensorsState. Adicionadas as enumerações GameInputSensorsKind e GameInputSensorAccuracy. Adicionados IGameInputDevice::DirectInputEscape e IGameInputDevice::GetHapticInfo. Adicionado IGameInputReading::GetSensorsState. Reintroduzida a estrutura GameInputVersion (ausente na v1). |
| v1 | Removidas a interface IGameInputRawDeviceReport, a estrutura GameInputRawDeviceReportInfo e a enumeração GameInputRawDeviceReportKind. Removida a estrutura GameInputVersion. Adicionada a enumeração GameInputMousePositions. Removidos os tipos de háptica, movimento e toque não implementados exclusivos da v0 (GameInputBatteryState, GameInputHapticFeedbackMotorInfo, GameInputHapticFeedbackParams, GameInputHapticWaveformInfo, GameInputMotionInfo, GameInputMotionState, GameInputTouchSensorInfo, GameInputTouchState, GameInputString, GameInputRawDeviceItemCollectionInfo, GameInputRawDeviceReportItemInfo). |
| v0 | Introduzida. |