Skip to main content

IGameInput::RegisterDeviceCallback

註冊一個 GameInputDeviceCallback 函式,每當有裝置連線至系統或從系統中斷連線時就會呼叫該函式。也可讓該函式在裝置的屬性變更時被呼叫。

語法

參數

device   _In_opt_
類型:IGameInputDevice*
將已註冊的回呼限制為只針對特定裝置觸發。 inputKind   _In_
類型:GameInputKind
將已註冊的回呼限制為只針對至少支援其中一種指定輸入類型的裝置觸發。 statusFilter   _In_
類型:GameInputDeviceStatus
將已註冊的回呼限制為只針對特定類型的裝置狀態變更觸發。 enumerationKind   _In_
類型:GameInputEnumerationKind
決定是否列舉裝置,以及函式是否會等待列舉完成。 context   _In_opt_
類型:void*
為回呼函式提供相關資訊的某個物件。通常是呼叫端物件。 callbackFunc   _In_
類型:GameInputDeviceCallback
要針對裝置連線或中斷連線事件註冊的遊戲定義回呼。 callbackToken   _Result_zeroonfailure_
類型:GameInputCallbackToken*
識別已註冊回呼函式的權杖。當您需要取消或取消註冊回呼函式時,會使用此權杖來識別已註冊的函式。

傳回值

類型:HRESULT 函式結果。

備註

由 IGameInput::RegisterDeviceCallback 註冊的函式可用來回應裝置的狀態變更,例如連線或中斷連線。可辨識的狀態變更類型列於 GameInputDeviceStatus。 enumerationKind 參數可用來產生一連串初始回呼,每個連線至系統的裝置各一個。此初始列舉可設定為非同步或同步列舉。同步列舉會在 IGameInput::RegisterDeviceCallback 傳回之前呼叫所有初始回呼。 下列 C++ 範例示範如何明確列舉已連線的遊戲台和鍵盤。
下列 C++ 範例示範如何在裝置連線或中斷連線時收到通知。

需求

輸入 API 概觀
IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback

版本歷程記錄

Last modified on October 6, 2026