메인 콘텐츠로 건너뛰기

XUserGetGamerPictureResult

XUserGetGamerPictureAsync 호출 결과를 가져옵니다.

구문

매개변수

async   _Inout_
형식: XAsyncBlock*
호출의 상태를 폴링하고 호출 결과를 가져오기 위한 XAsyncBlock입니다. bufferSize   _In_
형식: size_t
buffer 매개변수의 버퍼 크기입니다. buffer   _Out_writes_bytes_to_(bufferSize,bufferUsed)
형식: void
게이머 사진을 포함하는 버퍼입니다. bufferUsed   _Out_opt_
형식: size_t*
게이머 사진을 담기 위한 버퍼의 양을 포함합니다.

반환값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
오류 코드 목록은 Error Codes를 참조하십시오.

설명

“Display Name and Gamerpic” XR은 사용자 이름과 아바타 이미지가 어떻게 표시되는지에 대한 특정 요구 사항을 나열합니다. 자세한 내용은 XBOX One 게임 및 허브 앱에 대한 XBOX 요구 사항 (XBOX 개발자 다운로드->Partner, Publishing 및 Release Management 정보->XGD 파트너 문서)를 참조하십시오. XUserGetGamerPictureAsync 호출 결과를 가져오려면 XUserGetGamerPictureResult를 호출합니다. XUserGetGamerPictureAsync가 반환한 게이머 사진을 가져오기 위해 XUserGetGamerPictureResult에서 필요한 버퍼 크기를 가져오려면 XUserGetGamerPictureResultSize를 호출합니다. 반환되는 게이머 사진의 형식은 .PNG 형식의 이미지입니다. 사진의 크기는 최대 2^32 바이트가 될 수 있습니다. 다음 예제는 게이머 사진을 로드하는 방법을 보여줍니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, Steam Deck, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XUser XUserGetGamerPictureAsync XUserGetGamerPictureResultSize
마지막 수정일 2026년 10월 19일