語法
參數
infoArrayCount _In_類型:uint32_t infoArray 中的元素數目。若要擷取所有控制器切換開關,請傳遞 GetControllerSwitchCount 傳回的值。 infoArray _Out_writes_to_opt_(infoArrayCount, return)
類型:GameInputControllerSwitchInfo* 指向陣列的指標,此陣列會針對每個控制器切換開關接收一個結構。可以是
nullptr,在此情況下不會寫入任何內容,且方法會傳回 0。
傳回值
類型:uint32_t 寫入 infoArray 的元素數目。此值為 infoArrayCount 與裝置上控制器切換開關數目兩者中的較小值;如果 infoArray 為nullptr 或裝置沒有控制器切換開關,則為 0。
備註
每個元素都是一個 GameInputControllerSwitchInfo 結構,描述對應切換開關的類型 (雙向、四向或八向,以 GameInputSwitchKind 值表示) 及其每個位置的標籤。 呼叫 GetControllerSwitchCount 以取得控制器切換開關數目,配置該大小的陣列,然後呼叫GetControllerSwitchInfo 加以填入。如果 infoArrayCount 小於控制器切換開關數目,則只會寫入前 infoArrayCount 個元素。在裝置連線期間,裝置的控制器切換開關不會變更,因此您可以只查詢一次並快取結果。
資訊陣列的元素 i 描述此裝置之讀數的 IGameInputReading::GetControllerSwitchState 所傳回陣列中索引 i 處的切換開關。
下列範例示範如何擷取裝置的控制器切換開關。
controllerSwitchInfo 成員取得,該結構由 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 controllerInfo 成員參考。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀GetControllerSwitchCount
GameInputControllerSwitchInfo
GameInputSwitchKind
IGameInputReading::GetControllerSwitchState
IGameInputDevice
