Skip to main content

XGameSaveReadBlobData

컨테이너에 대한 Blob 데이터를 읽습니다.

구문

매개 변수

container   _In_
형식: XGameSaveContainerHandle
XGameSaveBlob 데이터를 포함하는 XGameSaveContainer 에 대한 핸들입니다. blobNames   _In_opt_z_count_(countOfBlobs)
형식: char
*
XGameSaveBlob 이름을 나타내는 문자열 배열에 대한 포인터입니다. countOfBlobs   _Inout_
형식: uint32_t*
읽을 Blob의 수입니다. blobsSize   _In_
형식: size_t
할당된 Blob 데이터의 크기입니다. Blob 메타데이터를 읽어서 유추할 수 있습니다. blobData   _Out_writes_bytes_(blobsSize)
형식: XGameSaveBlob*
Blob 데이터를 담을 XGameSaveBlob 포인터입니다. 컨테이너에서 요청된 모든 Blob을 저장할 메모리가 할당되어 있어야 합니다.

반환값

형식: HRESULT 함수 결과입니다.

일반적인 오류

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_PROVIDED_BUFFER_TOO_SMALL
  • E_GS_BLOB_NOT_FOUND
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

설명

이 함수는 시간에 민감한 스레드에서 호출해도 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
게임 저장 Blob의 데이터를 읽으려면 이 함수를 사용합니다. 이 함수는 Blob 컨테이너 내부의 Blob 수와 데이터를 반환합니다. 이러한 값을 사용하여 컨테이너의 Blob을 반복하며 적절한 정보를 읽을 수 있습니다. 이 함수에는 XGameSaveReadBlobDataAsync라는 비동기 버전이 있습니다.

요구 사항

헤더: XGameSave.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

XGameSave
XGameSaveBlobInfo
XGameSaveReadBlobDataAsync
게임 저장 디버깅
마지막 수정일 2026년 8월 24일