> ## 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::StopCallback (已淘汰)

> IGameInput::StopCallback API (已在 v4 中移除)。

> [!WARNING]
>
> **已淘汰。** 此方法已在 GameInput v4 中移除，目前的 API 中無法使用。請改用 [IGameInput::UnregisterCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)，在 v4 中可以從回呼內安全地呼叫該方法。

停止觸發回呼函式。

## 語法

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

### 參數

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

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

### 傳回值

類型：void

沒有傳回值。

## 備註

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

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

## 需求

**標頭：** GameInput.h

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[輸入 API 概觀](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)\
[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[IGameInput::RegisterReadingCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)\
[IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)\
[IGameInput::UnregisterCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)

## 版本歷程記錄

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


## Related topics

- [IGameInput::RegisterKeyboardLayoutCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::StopCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::RegisterGuideButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInputGuidButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::GetTemporalReading (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_gettemporalreading.md)