IGameInput::RegisterReadingCallback (v2)

注册在某一新读取到达输入流中时要调用的函数。

语法

HRESULT RegisterReadingCallback(
    IGameInputDevice* device,
    GameInputKind inputKind,
    void* context,
    GameInputReadingCallback callbackFunc,
    GameInputCallbackToken* callbackToken
);

参数

device _In_opt_
类型:IGameInputDevice*

将注册的回调限制为仅为某一特定设备触发。

inputKind _In_
类型:GameInputKind

将注册的回调限制为仅为支持至少一种指定的输入类型的设备触发。

context _In_opt_
类型:void*

提供有关回调函数的相关信息的某些对象。 通常的调用对象。

callbackFunc _In_
类型:GameInputReadingCallback

游戏定义的回调函数。

callbackToken _Result_zeroonfailure_
类型:GameInputCallbackToken*

标识注册的回调函数的令牌。 此令牌将用于在您想要取消或注销回调函数时标识已注册的函数。

返回值

类型:HRESULT

函数结果。

备注

注册回调不会导致使用与提供的输入筛选器匹配的最近的读取调度初始回调。 它仅导致为后续的状态变化调度回调。

要求

头文件:GameInput.h

库:gameinput.lib

支持的平台: 窗户

另请参阅

输入 API 概述
IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback