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

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

## 語法

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

### 參數

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

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

### 傳回值

類型：HRESULT

函式結果。

## 備註

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

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

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

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

## 另請參閱

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

## 版本歷程記錄

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


## Related topics

- [IGameInput::DisableAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md)
- [IGameInput::CreateAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)
- [IGameInput::FindDeviceFromObject](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)