Pular para o conteúdo principal

XUserGetGamerPictureResult

Recupera o resultado de uma chamada para XUserGetGamerPictureAsync.

Sintaxe

Parâmetros

async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada. bufferSize   _In_
Tipo: size_t
O tamanho do buffer no parâmetro buffer. buffer   _Out_writes_bytes_to_(bufferSize,bufferUsed)
Tipo: void
Um buffer que contém a imagem de jogador. bufferUsed   _Out_opt_
Tipo: size_t*
Contém a quantidade do buffer usada para armazenar a imagem de jogador.

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 XUserGetGamerPictureAsync XUserGetGamerPictureResultSize
Última modificação em 6 de outubro de 2026