Skip to main content

IGameInput::GetCurrentReading

從輸入串流擷取符合呼叫端所提供篩選條件的最新讀數。

語法

參數

inputKind   _In_
類型:GameInputKind
其中一個列舉值,指定所使用的輸入裝置類型,例如控制器、鍵盤、滑鼠或遊戲台。列舉值可以合併,以指定多種輸入類型。指定多種輸入種類時,任何包含至少一種輸入種類的讀數都會被比對並傳回。 device   _In_opt_
類型:IGameInputDevice*
選擇性篩選條件,傳回來自特定裝置的讀數。 reading   _COM_Outptr_
類型:IGameInputReading**
要傳回的輸入讀數。失敗時傳回 NULL。

傳回值

類型:HRESULT 函式結果。

備註

此函式用於初次存取輸入串流。您可以將此函式與 GetNextReading 和 GetPreviousReading 方法搭配使用,以逐步瀏覽輸入串流而不遺漏輸入。或者,如果您的遊戲可以容許遺漏部分輸入,您也可以繼續呼叫 GetCurrentReading 以持續取得最新的讀數。 下列程式碼範例示範如何輪詢目前的遊戲台狀態。
下列程式碼範例示範如何從特定裝置輪詢目前的遊戲台狀態。
下列程式碼範例示範如何從特定裝置輪詢所有遊戲台狀態。

需求

輸入 API 概觀
IGameInput_GetNextReading
IGameInput_GetPreviousReading
IGameInput

版本歷程記錄

Last modified on October 6, 2026