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**
傳回的 IGameInputReading 介面,依序位於 referenceReading 輸入之後。

傳回值

類型:HRESULT 函式結果。

備註

GetNextReading 和 GetPreviousReading 方法可讓應用程式逐一讀數地瀏覽輸入歷程記錄。 如果 referenceReading 之後沒有讀數、為已中斷連線的裝置提供裝置篩選條件,或經過太多時間導致參考讀數和傳回的讀數已離開輸入串流歷程記錄緩衝區,則會傳回 NULL 值和失敗 HRESULT。對於持續處理輸入的應用程式而言,經過時間錯誤很少見,因為輸入串流會在其歷程記錄緩衝區中保留每個裝置半秒的讀數。 下列程式碼範例示範如何從特定裝置輪詢所有遊戲台狀態。

需求

標頭: GameInput.h GameInput 概觀
IGameInput_GetCurrentReading
IGameInput_GetPreviousReading
IGameInput

版本歷程記錄

Last modified on October 6, 2026