Skip to main content

IGameInput::CreateAggregateDevice

Cria uma instância virtual de IGameInputDevice que agrega todas as entradas do GameInputKind especificado.

Sintaxe

Parâmetros

inputKind   _In_
Tipo: GameInputKind
O tipo de entrada para o qual o IGameInputDevice virtual retornado agregará leituras. deviceId   _Out_
Tipo: APP_LOCAL_DEVICE_ID*
O identificador de dispositivo resultante para o dispositivo agregado.

Valor retornado

Tipo: HRESULT Resultado da função. Uma falha é retornada quando um GameInputKind sem suporte é usado ou ao tentar combinar sinalizadores de GameInputKind.

Comentários

O tipo de entrada usado para CreateAggregateDevice deve ser um único valor da enumeração GameInputKind. Não há suporte para combinar sinalizadores de GameInputKind. Se um aplicativo precisar de entrada agregada para vários tipos de entrada, ele deverá criar uma instância virtual de IGameInputDevice para cada um.
Essa função é usada para reabilitar um dispositivo agregado que possa ter sido desabilitado chamando DisableAggregateDevice. Ela faz com que o dispositivo seja reabilitado, em vez de criar outra instância.
O dispositivo agregado também emitirá notificações de status por meio do retorno de chamada registrado ao chamar RegisterDeviceCallback. A agregação tem suporte apenas para os seguintes tipos de entrada:
  • GameInputKindKeyboard
  • GameInputKindMouse
  • GameInputKindArcadeStick
  • GameInputKindFlightStick
  • GameInputKindGamepad
  • GameInputKindRacingWheel

Requisitos

Cabeçalho: GameInput.h Visão geral da API de entrada
IGameInput

Histórico de versões

Last modified on October 6, 2026