Skip to main content

IGameInput::GetNextReading

オプションでフィルターされた入力ストリームからの参照読み取り値に基づいて、次に利用可能な IGameInputReading インターフェイスを取得します。

構文

パラメーター

referenceReading   _In_
型: IGameInputReading*
現在の IGameInputReading。返される IGameInputReading インターフェイスは、この参照読み取り値の次の読み取り値です。 inputKind   _In_
型: GameInputKind
次の読み取り値を取得する入力の種類のフィルター。GameInputKind インターフェイスはフラグ変数です。複数の値を組み合わせて複数の GameInputKind 定数でフィルターできます。複数の入力種別が指定されている場合、それらの入力種別の少なくとも 1 つを含む読み取り値が一致し、返されます。 device   _In_opt_
型: IGameInputDevice*
次の読み取り値を取得する特定のデバイスのフィルター。 reading   _COM_Outptr_
型: IGameInputReading**
referenceReading 入力の後に順番に続く、返される IGameInputReading インターフェイス。

戻り値

型: HRESULT 関数の結果。

解説

GetNextReading および GetPreviousReading メソッドは、アプリが入力履歴を読み取り単位で移動できるようにします。 referenceReading の後に読み取り値がない場合、切断されたデバイスに対してデバイス フィルターが提供された場合、または時間が経ちすぎて参照読み取り値と返される読み取り値が入力ストリームの履歴バッファーから外れた場合、NULL 値と失敗の HRESULT を返します。入力ストリームは履歴バッファーに各デバイスから 0.5 秒間の読み取り値を保持するため、入力を継続的に処理するアプリでは経過時間エラーはまれです。 次のコード例は、特定のデバイスからすべてのゲームパッドの状態をポーリングする方法を示します。

要件

ヘッダー: GameInput.h GameInput の概要
IGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput

バージョン履歴

最終更新日 2026年8月13日