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

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

> [!NOTE]
>
> To re-enable a disabled aggregate device, call [CreateAggregateDevice](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md) 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](https://docs.xbox.com/build/core-features/common/input/overviews/input-overview.md)\

[IGameInput](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/igameinput.md)\

[CreateAggregateDevice](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)

## Version History

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


## Related topics

- [IGameInput::CreateAggregateDevice](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)
- [IGameInput::FindDeviceFromId](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::FindDeviceFromObject (Deprecated)](https://docs.xbox.com/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)
- [IGameInput::FindDeviceFromPlatformString](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromplatformstring.md)