Skip to main content

XUserGetGamerPictureAsync

以非同步方式擷取特定使用者的玩家圖片。

語法

參數

user   _In_
類型:XUserHandle
要擷取其玩家圖片的使用者。 pictureSize   _In_
類型:XUserGamerPictureSize
要擷取的玩家圖片大小。 async   _Inout_
類型:XAsyncBlock*
用於輪詢呼叫狀態及擷取呼叫結果的 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。
如需錯誤碼清單,請參閱錯誤碼。

備註

「顯示名稱與玩家圖片」XR 列出了使用者名稱和虛擬人偶影像顯示方式的特定需求。 如需詳細資訊,請參閱 XBOX One 遊戲和中樞應用程式的 XBOX 需求 (XBOX 開發人員下載->合作夥伴、發行和發行管理資訊->XGD 合作夥伴文件)。 若要擷取呼叫 XUserGetGamerPictureAsync 的結果,請呼叫 XUserGetGamerPictureResult。 若要擷取 XUserGetGamerPictureResult 擷取 XUserGetGamerPictureAsync 所傳回之玩家圖片所需的緩衝區大小,請呼叫 XUserGetGamerPictureResultSize。 傳回的玩家圖片格式為 .PNG 格式影像。圖片大小最多可達 2^32 位元組。 下列範例示範如何載入玩家圖片。

需求

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

概念文件

另請參閱

XUser XUserGetGamerPictureResult XUserGetGamerPictureResultSize
Last modified on October 6, 2026