Skip to main content

IGameInput::DisableAggregateDevice

Disables an aggregate device that matches the specified device ID.

Syntax

Parameters

deviceId   _In_
Type: const APP_LOCAL_DEVICE_ID*
The device identifier of the aggregate device to disable.

Return value

Type: HRESULT Function result.

Remarks

This method disables an aggregate device that matches the specified device ID. Once disabled, the aggregate device stops sending aggregated readings and tracking status changes until it’s re-enabled again using CreateAggregateDevice with the same GameInputKind value that was used to create it.
To re-enable a disabled aggregate device, call CreateAggregateDevice with the same input kind that was originally used to create the device. This will re-enable the existing device rather than creating a new instance.

Requirements

Header: GameInput.h Library: gameinput.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

Overview of GameInput
IGameInput
CreateAggregateDevice

Version History

Last modified on August 31, 2026