Skip to main content

IGameInput::GetCurrentReading

从输入流中检索与调用方提供的筛选器匹配的最新读数。

语法

参数

inputKind   _In_
类型:GameInputKind
指示正在使用的输入设备类型(例如控制器、键盘、鼠标或游戏手柄)的枚举值之一。可以组合多个枚举值以指示多种输入类型。指定多种输入类型时,任何至少包含其中一种输入类型的读数都会被匹配并返回。 device   _In_opt_
类型:IGameInputDevice*
一个可选的筛选器,用于返回特定设备的读数。 reading   _COM_Outptr_
类型:IGameInputReading**
要返回的输入读数。失败时返回 NULL

返回值

类型:HRESULT 函数结果。

备注

此函数用于初次访问输入流。可以将此函数与 GetNextReadingGetPreviousReading 方法一起使用,以逐个读数遍历输入流而不遗漏任何输入。或者,如果你的游戏可以允许错过一些输入,你可以继续调用 GetCurrentReading 以持续获取最新的读数。 以下代码示例演示了如何轮询当前游戏手柄状态。
以下代码示例演示了如何从特定设备轮询当前游戏手柄状态。
以下代码示例演示了如何从特定设备轮询所有游戏手柄状态。

要求

输入 API 概述
IGameInput_GetNextReading
IGameInput_GetPreviousReading
IGameInput

版本历史

最后修改于 2026年8月13日