跳轉到主要內容
擷取裝置上一般控制器軸的標籤。

語法

參數

labelArrayCount   _In_
類型:uint32_t
labelArray 中的元素數目。若要擷取所有控制器軸標籤,請傳遞 GetControllerAxisCount 傳回的值。 labelArray   _Out_writes_to_opt_(labelArrayCount, return)
類型:GameInputLabel*
指向陣列的指標,此陣列會針對每個控制器軸接收一個標籤。可以是 nullptr,在此情況下不會寫入任何內容,且方法會傳回 0。

傳回值

類型:uint32_t 寫入 labelArray 的元素數目。此值為 labelArrayCount 與裝置上控制器軸標籤數目兩者中的較小值;如果 labelArray 為 nullptr 或裝置沒有控制器軸標籤,則為 0。

備註

每個元素都是一個 GameInputLabel 值,用來識別對應軸上印製的標記 (如果裝置有回報的話)。 呼叫 GetControllerAxisCount 以取得控制器軸標籤數目,配置該大小的陣列,然後呼叫 GetControllerAxisLabels 加以填入。如果 labelArrayCount 小於控制器軸標籤數目,則只會寫入前 labelArrayCount 個元素。在裝置連線期間,裝置的控制器軸標籤不會變更,因此您可以只查詢一次並快取結果。 標籤陣列的元素 i 描述此裝置之讀數的 IGameInputReading::GetControllerAxisState 所傳回陣列中索引 i 處的軸。 下列範例示範如何擷取裝置的控制器軸標籤。
在 GameInput v3 及更早版本中,此資訊可從 GameInputControllerInfo 結構的 controllerAxisLabels 成員取得,該結構由 IGameInputDevice::GetDeviceInfo 所傳回 GameInputDeviceInfo 結構的 controllerInfo 成員參考。

需求

標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameInput 概觀
GetControllerAxisCount
GameInputLabel
IGameInputReading::GetControllerAxisState
IGameInputDevice

版本歷程記錄

最後修改於 2026年11月6日