語法
參數
info _Out_類型:GameInputKeyboardInfo* 指向
GameInputKeyboardInfo 結構的指標,此結構會接收裝置的鍵盤屬性。如果裝置不支援鍵盤輸入,結構的每個成員都會設定為零。
傳回值
類型:bool 如果裝置支援鍵盤輸入且已填入 info,則為true;否則為 false。
備註
GetKeyboardInfo 方法會將裝置的鍵盤屬性複製到呼叫端提供的結構中。當 GetSupportedInput 傳回的值包含 GameInputKindKeyboard 時,裝置即支援鍵盤輸入。如果裝置不支援鍵盤輸入,GetKeyboardInfo 會將 info 初始化為零並傳回 false。
大部分的鍵盤屬性在裝置的存留期間內固定不變。例外的是 layout 成員,當作用中的鍵盤配置變更時 (例如,當使用者切換輸入語言時),GameInput 會就地更新此成員。當配置變更時,GameInput 會對透過 IGameInput::RegisterDeviceCallback 註冊的裝置回呼引發 GameInputDeviceEventKeyboardLayoutUpdated GameInputDeviceEvent。請從該回呼中再次呼叫 GetKeyboardInfo 以讀取新的配置。
下列範例示範如何查詢裝置的鍵盤屬性。
keyboardInfo 成員取得。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice
