語法
參數
bufferByteCount _In_類型:uint32_t buffer 所指向之緩衝區的大小 (以位元組為單位)。傳遞 0 以查詢所需的大小。 buffer _Out_writes_bytes_opt_(bufferByteCount)
類型:char* 接收以 Null 結尾之 UTF-8 PnP 路徑的緩衝區。傳遞
nullptr 以查詢所需的大小。
傳回值
類型:uint32_t 容納 PnP 路徑所需的緩衝區大小 (以位元組為單位),包括 Null 結束字元。備註
只有在 buffer 不是nullptr 且 bufferByteCount 大於或等於所需的大小時,此方法才會將 PnP 路徑寫入 buffer。否則,緩衝區不會遭到修改。若要擷取路徑,請先以 0 的 bufferByteCount 和 nullptr 的 buffer 呼叫此方法一次以取得所需的大小,配置該大小的緩衝區,然後再次呼叫此方法。
如果裝置沒有 PnP 路徑,所需的大小為 1,且此方法會寫入空字串。
使用 PnP 路徑透過其他 API 參考基礎裝置。由於路徑是以 UTF-8 編碼,因此在將其傳遞給預期寬字元字串的 Windows API 之前,請先將其轉換為 UTF-16 (例如,使用搭配 CP_UTF8 的 MultiByteToWideChar)。
PnP 路徑在裝置物件的存留期間內不會變更。
下列範例會擷取裝置的 PnP 路徑。
pnpPath 成員取得。
需求
標頭: GameInput.h 程式庫: gameinput.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機另請參閱
GameInput 概觀IGameInputDevice
IGameInputDevice::GetDisplayName
IGameInputDevice::GetContainerId
