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