Skip to main content

IGameInput::GetNextReading

基于来自(可选筛选的)输入流的参考读数,检索下一个可用的 IGameInputReading 接口。

语法

参数

referenceReading   _In_
类型:IGameInputReading*
当前的 IGameInputReading。返回的 IGameInputReading 接口是位于此参考读数之后的下一个读数。 inputKind   _In_
类型:GameInputKind
用于从中获取下一个读数的输入类型筛选器。GameInputKind 接口是一个标志变量。你可以组合多个值以按多个 GameInputKind 常量进行筛选。指定多种输入类型时,任何至少包含其中一种输入类型的读数都会被匹配并返回。 device   _In_opt_
类型:IGameInputDevice*
用于从中获取下一个读数的特定设备筛选器。 reading   _COM_Outptr_
类型:IGameInputReading**
referenceReading 输入之后按顺序返回的 IGameInputReading 接口。

返回值

类型:HRESULT 函数结果。

备注

GetNextReadingGetPreviousReading 方法允许应用逐个读数地遍历输入历史记录。 如果在 referenceReading 之后没有读数,或者提供的设备筛选器对应已断开连接的设备,或者由于时间过长导致参考读数与返回的读数已离开输入流历史缓冲区,则返回 NULL 值和失败的 HRESULT。对于持续处理输入的应用而言,超时错误很少见,因为输入流会在其历史缓冲区中为每个设备保留半秒的读数。 以下代码示例演示了如何从特定设备轮询所有游戏手柄状态。

要求

标头: GameInput.h GameInput 概述
IGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput

版本历史

最后修改于 2026年8月13日