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

> IGameInput::StopCallback

# IGameInput::StopCallback

停止觸發回呼函式。

## 語法

```cpp theme={null}
void StopCallback(
    GameInputCallbackToken callbackToken
);
```

### 參數

*callbackToken*   \_In\_\
類型：GameInputCallbackToken

要停止之回呼函式的權杖。在函式最初以 [IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) 註冊時產生。

### 傳回值

類型：void

沒有傳回值。

## 備註

此函式與 [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback) 函式的不同之處在於，它無法確保您可以安全地從回呼函式移除資源，但可以從回呼函式內呼叫它。

**StopCallback** 方法和 [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback) 方法略有不同。呼叫任一方法都能確保相關聯的回呼不會再次分派。不過，在 [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback) 函式成功傳回之前，釋放與回呼相關聯的任何資源 (例如，卸載裝載回呼函式的 DLL) 並不安全。因此，無法從回呼本身所註冊的回呼函式內取消註冊該回呼，嘗試這麼做會觸發嚴重判斷提示。不過，從回呼函式內取消回呼是安全的。

## 需求

**標頭：** GameInput.h

[輸入 API 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)\
[IGameInput::RegisterReadingCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback)\
[IGameInput::RegisterSystemButtonCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)

## 版本歷程記錄

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


## Related topics

- [IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterReadingCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::RegisterSystemButtonCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
