IGameInput::StopCallback (v0)

停止触发回调函数。

语法

void StopCallback(  
         GameInputCallbackToken callbackToken  
)  

参数

callbackToken _In_
类型:GameInputCallbackToken

要注销的回调函数的标记。 在使用 IGameInput::RegisterDeviceCallback 最初注册函数时生成。

返回值

类型:void

无返回值。

备注

此函数与其他函数的不同之处在于,它并没有使您能够安全地从回调函数中删除资源,但可以从回调函数中调用它。

StopCallback 方法和 IGameInput::UnregisterCallback 方法稍有不同。 调用这两种方法中的任何一种都确保不会重新调度关联的回调。 但是,在 IGameInput::UnregisterCallback 函数成功返回前,释放与该回调相关的任何资源都是不安全的(例如,上传托管回调函数的 DLL)。 因此,无法从其已注册的回调函数内注销某一回调,并且尝试这样做会导致返回错误。 但是,从回调函数内取消某一回调是安全的。

要求

头文件:GameInput.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

输入 API 概述
IGameInput
IGameInput::RegisterDeviceCallback
IGameInput::RegisterReadingCallback
IGameInput::RegisterSystemButtonCallback