Skip to main content

​
XGameSaveSubmitBlobWrite

XGameSaveUpdate에 쓰기 동작을 추가합니다.

​
구문

​
매개 변수

updateContext   _In_
형식: XGameSaveUpdateHandle Blob이 기록될 XGameSaveUpdate 에 대한 핸들입니다. blobName   _In_z_
형식: char* 기록될 Blob의 이름입니다. Blob 이름의 크기는 GS_MAX_BLOB_NAME_SIZE(바이트 단위)를 초과해서는 안 됩니다. data   _In_reads_bytes_(byteCount)
형식: uint8_t* Blob에 기록될 데이터입니다. byteCount   _In_
형식: size_t Blob에 기록될 데이터의 크기입니다. Blob 데이터의 크기는 GS_MAX_BLOB_SIZE(바이트 단위)를 초과해서는 안 됩니다.
Blob 데이터의 크기는 GS_MAX_BLOB_SIZE로 제한되지만, 업데이트 전체도 GS_MAX_BLOB_SIZE로 제한됩니다. 업데이트에 GS_MAX_BLOB_SIZE 크기의 Blob이 포함된 경우 추가 업데이트는 별도의 업데이트 요청으로 수행해야 합니다.

​
반환값

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

​
설명

이 함수는 시간에 민감한 스레드에서 호출해도 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
이 호출을 하기 전에 XGameSaveCreateUpdate를 성공적으로 호출해야 합니다. 이 API의 저장소 부분은 게임에서 지속적인 저장소로 안전하고 신뢰할 수 있으며 트랜잭션 방식으로 데이터를 쉽게 전송하도록 설계되었습니다. 컨테이너의 뒷단 데이터가 항상 일관되도록 하고자 하므로, 전체 작업이 원자적으로 성공하거나 실패하도록 하려고 합니다. 일부 Blob 데이터가 컨테이너 내의 다른 데이터와 일치하지 않는 부분 업데이트가 발생하지 않도록 합니다. 이를 위해 Blob 쓰기 및 삭제가 제출되는 업데이트 컨텍스트를 제공하고, 준비되면 전체 컨텍스트가 제출됩니다. 하나의 업데이트 컨텍스트에서 Blob당 하나의 수정/삭제만 기록할 수 있습니다. 실제로는 다음과 같이 진행됩니다. XGameSaveUpdate는 XGameSaveSubmitBlobWrite 및 XGameSaveSubmitBlobDelete를 통해 컨테이너 내의 Blob에서 수행할 쓰기 및 삭제 동작으로 채워집니다. XGameSaveSubmitUpdate를 호출하여 업데이트를 완료합니다. 사용법은 XGameSaveCreateUpdate 예제를 참조하세요.

​
요구 사항

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

​
개념 설명서

​
함께 보기

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitUpdate
XGameSaveSubmitBlobDelete
게임 저장 디버깅
마지막 수정일 2026년 8월 24일

관련 항목

XGameSaveSubmitBlobDeleteXGameSaveSubmitUpdateXGameSaveSubmitUpdateAsyncXGameSaveCreateUpdateXGameSave API 개요