> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInput::DisableAggregateDevice

> IGameInput::DisableAggregateDevice

# IGameInput::DisableAggregateDevice

Disables an aggregate device that matches the specified device ID.

## Syntax

```cpp theme={null}
HRESULT DisableAggregateDevice(
         const APP_LOCAL_DEVICE_ID* deviceId
)
```

### 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](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice) with the same [GameInputKind](/reference/input/gameinput/enums/gameinputkind) value that was used to create it.

<Note>To re-enable a disabled aggregate device, call [CreateAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_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.</Note>

## Requirements

**Header:** GameInput.h

**Library:** gameinput.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

[Overview of GameInput](/build/core-features/common/input/overviews/input-overview)<br />
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)<br />
[CreateAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice)

## Version History

| Version | Changes     |
| ------- | ----------- |
| **v3**  | Introduced. |


## Related topics

- [IGameInput::CreateAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)
- [IGameInput::FindDeviceFromObject](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromId](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::FindDeviceFromPlatformHandle](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromplatformhandle.md)