XGameSaveSubmitBlobWrite

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

구문

HRESULT XGameSaveSubmitBlobWrite(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName,  
         const uint8_t* data,  
         size_t byteCount  
)  

매개 변수

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 examples를 참조하세요.

요구 사항

헤더: XGameSave.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitUpdate
XGameSaveSubmitBlobDelete
게임 저장 오류