Skip to main content

IGameInput::GetPreviousReading

根據參考讀數,從可選擇性篩選的輸入串流中擷取前一個 IGameInputReading。

語法

參數

referenceReading   _In_
類型:IGameInputReading*
傳回的 IGameInputReading 介面在順序上會在此參考讀數之前讀取。 inputKind   _In_
類型:GameInputKind
用來篩選要從中擷取前一個讀數的輸入類型。GameInputKind 介面是旗標變數。您可以結合多個值,以依多個常數進行篩選。指定多個輸入類型時,任何至少包含其中一種輸入類型的讀數都會被比對並傳回。 device   _In_opt_
類型:IGameInputDevice*
用來篩選要從中擷取前一個讀數的特定裝置。 reading   _COM_Outptr_
類型:IGameInputReading**
傳回的 IGameInputReading 介面,在順序上位於 referenceReading 輸入之前。

傳回值

類型:HRESULT 函式結果。

備註

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

需求

GameInput
GameInput 概觀
IGameInput_GetCurrentReading
IGameInput_GetNextReading
IGameInput

版本歷程記錄

Last modified on October 6, 2026