Skip to main content

XUserGetGamerPictureAsync

Recupera de forma assíncrona a imagem de jogador de um usuário específico.

Sintaxe

Parâmetros

user   _In_
Tipo: XUserHandle
O usuário para o qual recuperar a imagem de jogador. pictureSize   _In_
Tipo: XUserGamerPictureSize
O tamanho da imagem de jogador a ser recuperada. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT.
Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

O XR “Nome de exibição e imagem de jogador” lista requisitos específicos sobre como os nomes de usuário e as imagens de avatar são exibidos. Consulte os Requisitos do XBOX para jogos e aplicativos Hub do XBOX One (Downloads para desenvolvedores do XBOX->Parceiro, publicação e informações de gerenciamento de lançamento->Documentação de parceiros XGD) para obter detalhes. Para recuperar o resultado de uma chamada para XUserGetGamerPictureAsync, chame XUserGetGamerPictureResult. Para recuperar o tamanho do buffer exigido por XUserGetGamerPictureResult para recuperar a imagem de jogador retornada por XUserGetGamerPictureAsync, chame XUserGetGamerPictureResultSize. O formato da imagem de jogador retornada é uma imagem no formato .PNG. O tamanho da imagem pode ser de até 2^32 bytes. O exemplo a seguir demonstra como carregar uma imagem de jogador.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XUser XUserGetGamerPictureResult XUserGetGamerPictureResultSize
Last modified on October 6, 2026