語法
參數
bufferByteCount _In_類型:uint32_t buffer 所指向之緩衝區的大小 (以位元組為單位)。傳遞 0 以查詢所需的大小。 buffer _Out_writes_bytes_opt_(bufferByteCount)
類型:char* 接收以 Null 結尾之 UTF-8 顯示名稱的緩衝區。傳遞
nullptr 以查詢所需的大小。
傳回值
類型:uint32_t 容納顯示名稱所需的緩衝區大小 (以位元組為單位),包括 Null 結束字元。備註
只有在 buffer 不是nullptr 且 bufferByteCount 大於或等於所需的大小時,此方法才會將顯示名稱寫入 buffer。否則,緩衝區不會遭到修改。若要擷取顯示名稱,請先以 0 的 bufferByteCount 和 nullptr 的 buffer 呼叫此方法一次以取得所需的大小,配置該大小的緩衝區,然後再次呼叫此方法。
如果裝置沒有顯示名稱,所需的大小為 1,且此方法會寫入空字串。
顯示名稱是裝置的「易記」名稱。您可以在應用程式的 UI 中顯示它,但無法保證它已當地語系化。GameInput 會在數個位置搜尋此字串,而最終的後援來源之一是裝置的韌體。
顯示名稱在裝置物件的存留期間內不會變更。
下列範例會擷取裝置的顯示名稱。
displayName 成員取得。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀IGameInputDevice
IGameInputDevice::GetPnpPath
