> ## 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

# IGameInput::DisableAggregateDevice

停用符合指定裝置識別碼的彙總裝置。

## 語法

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

### 參數

*deviceId*   \_In\_\
類型：const APP\_LOCAL\_DEVICE\_ID\*

要停用之彙總裝置的裝置識別碼。

### 傳回值

類型：HRESULT

函式結果。

## 備註

此方法會停用符合指定裝置識別碼的彙總裝置。停用後，彙總裝置會停止傳送彙總讀數及追蹤狀態變更，直到使用建立時所用的相同 [GameInputKind](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputkind.md) 值呼叫 [CreateAggregateDevice](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md) 重新啟用為止。

> [!NOTE]
>
> 若要重新啟用已停用的彙總裝置，請使用最初建立裝置時所用的相同輸入種類呼叫 [CreateAggregateDevice](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)。這會重新啟用現有的裝置，而不是建立新的執行個體。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\

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

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

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | 已推出。 |


## Related topics

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