跳轉到主要內容
已淘汰。 此方法已在 GameInput v4 中移除,目前的 API 中無法使用。請改為處理 GameInputDeviceEventKeyboardLayoutUpdated 裝置事件,並呼叫 IGameInputDevice::GetKeyboardInfo 以取得新的配置。
註冊在鍵盤配置變更時呼叫的回呼函式。

語法

參數

device   _In_opt_
類型:IGameInputDevice*
可選擇性地將已註冊的回呼限制為針對特定裝置觸發。 context   _In_opt_
類型:void*
為回呼函式提供相關資訊的物件。通常是呼叫端物件。 callbackFunc   _In_
類型:GameInputKeyboardLayoutCallback
在鍵盤配置變更時呼叫的遊戲定義回呼函式。 callbackToken   _Result_zeroonfailure_
類型:GameInputCallbackToken*
識別已註冊回呼函式的權杖。當您需要取消或取消註冊回呼函式時,會使用此權杖來識別已註冊的函式。

傳回值

類型:HRESULT 函式結果。

備註

RegisterKeyboardLayoutCallback 方法會註冊在鍵盤配置變更時呼叫的回呼函式。如需相關資訊,請參閱 IGameInput::UnregisterCallback 和 IGameInput::StopCallback 方法。如需 GameInput API 的中階和進階使用案例,請參閱 GameInput 進階主題。

需求

RegisterKeyboardLayoutCallback 方法會註冊在鍵盤配置變更時呼叫的回呼函式。如需相關資訊,請參閱 IGameInput::UnregisterCallback 和 IGameInput::StopCallback 方法。如需 GameInput API 的中階和進階使用案例,請參閱 GameInput 進階主題。 標頭: GameInput.h

另請參閱

已淘汰的 GameInput API 成員
GameInputDeviceEvent
IGameInputDevice::GetKeyboardInfo
GameInput 概觀
IGameInput

版本歷程記錄

最後修改於 2026年11月6日