Skip to main content

​
IGameInput::CreateAggregateDevice

Crea una instancia virtual de IGameInputDevice que agrega toda la entrada del tipo GameInputKind especificado.

​
Sintaxis

​
Parámetros

inputKind   _In_\ Tipo: GameInputKind El tipo de entrada para el que la instancia virtual de IGameInputDevice devuelta agregará lecturas. deviceId   _Out_\ Tipo: APP_LOCAL_DEVICE_ID* El identificador de dispositivo resultante del dispositivo agregado.

​
Valor devuelto

Tipo: HRESULT Resultado de la función. Devuelve un error cuando se usa un valor de GameInputKind no compatible o cuando se intenta combinar marcas de GameInputKind.

​
Comentarios

El tipo de entrada usado para CreateAggregateDevice debe ser un único valor de la enumeración GameInputKind. No se admite la combinación de marcas de GameInputKind. Si una aplicación necesita entrada agregada para varios tipos de entrada, debe crear una instancia virtual de IGameInputDevice para cada uno.
Esta función se usa para volver a habilitar un dispositivo agregado que pueda haberse deshabilitado mediante una llamada a DisableAggregateDevice. El resultado es que se vuelve a habilitar el dispositivo en lugar de crearse otra instancia.
El dispositivo agregado también emitirá notificaciones de estado a través de la devolución de llamada registrada mediante una llamada a RegisterDeviceCallback. La agregación solo se admite para los tipos de entrada siguientes:
  • GameInputKindKeyboard
  • GameInputKindMouse
  • GameInputKindArcadeStick
  • GameInputKindFlightStick
  • GameInputKindGamepad
  • GameInputKindRacingWheel

​
Requisitos

Encabezado: GameInput.h Información general de la API de entrada
IGameInput

​
Historial de versiones

Última modificación el 28 de agosto de 2026

Temas relacionados

IGameInput::CreateDispatcherIGameInput::FindDeviceFromObjectIGameInput::FindDeviceFromIdIGameInput::RegisterDeviceCallbackIGameInput::FindDeviceFromPlatformHandle