Skip to main content

XUserGetGamerPictureResult

Retrieves the result of a call to XUserGetGamerPictureAsync.

Syntax

Parameters

async   _Inout_
Type: XAsyncBlock*
An XAsyncBlock for polling the call’s status and retrieving call results. bufferSize   _In_
Type: size_t
The size of the buffer in the buffer parameter. buffer   _Out_writes_bytes_to_(bufferSize,bufferUsed)
Type: void
A buffer that contains the gamer picture. bufferUsed   _Out_opt_
Type: size_t*
Contains the amount of the buffer for holding the gamer picture.

Return value

Type: HRESULT HRESULT success or error code.
For a list of error codes, see Error Codes.

Remarks

The “Display Name and Gamerpic” XR lists specific requirements for how user names and avatar images are displayed. Consult XBOX Requirements for XBOX One Games and Hub Apps (XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation) for details. To retrieve the result of a call to XUserGetGamerPictureAsync, call XUserGetGamerPictureResult. To retrieve the buffer size required by XUserGetGamerPictureResult to retrieve the gamer picture returned by XUserGetGamerPictureAsync, call XUserGetGamerPictureResultSize. The format of the returned gamer picture is a .PNG formatted image. The size of the picture could be up to 2^32 bytes. The following example demonstrates how to load a gamer picture.

Requirements

Header: XUser.h Library: xgameruntime.lib Supported platforms: Windows, Steam Deck, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

XUser XUserGetGamerPictureAsync XUserGetGamerPictureResultSize
Last modified on October 19, 2026