IGameInput::StopCallback (v1)

停止触发回调函数。

语法

void StopCallback(
    GameInputCallbackToken callbackToken
);

参数

callbackToken _In_
类型:GameInputCallbackToken

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

返回值

类型:void

无返回值。

备注

此函数与 IGameInput::UnregisterCallback 函数的不同之处在于,它不能安全地从回调函数中删除资源,但可以从回调函数调用它。

StopCallback 方法和 IGameInput::UnregisterCallback 方法稍有不同。 调用这两种方法中的任何一种都确保不会重新调度关联的回调。 但是,在 IGameInput::UnregisterCallback 函数成功返回之前,释放与回调 (关联的任何资源是不安全的,例如,卸载承载回调函数的 DLL) 。 因此,无法从其已注册的回调函数中注销回调,尝试这样做将触发致命断言。 但是,从回调函数内取消某一回调是安全的。

要求

头文件:GameInput.h

库:gameinput.lib

支持的平台: 窗户

另请参阅

输入 API 概述IGameInputIGameInput::RegisterDeviceCallbackIGameInput::RegisterReadingCallbackIGameInput::RegisterSystemButtonCallback