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++ 範例示範如何明確列舉已連線的遊戲台和鍵盤。需求
輸入 API 概觀IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback
