Skip to main content

XblTitleStorageUploadBlobAsync

將 Blob 資料上傳至遊戲儲存體。

語法

參數

xboxLiveContext   _In_
類型:XblContextHandle
使用 XblContextCreateHandle 建立的 XBOX Live 內容控制代碼。 blobMetadata   _In_
類型:XblTitleStorageBlobMetadata
包含將緩衝區上傳至遊戲儲存體所需的屬性。上傳至少需要服務設定識別碼、Blob 路徑、Blob 類型和儲存體類型。 blobBuffer   _In_
類型:uint8_t*
包含要上傳之 Blob 資料的緩衝區。此緩衝區在非同步作業期間必須保持可用。用戶端不應在上傳進行中修改緩衝區。 blobBufferCount   _In_
類型:size_t
blobBuffer 的長度。 etagMatchCondition   _In_
類型:XblTitleStorageETagMatchCondition
用來判斷是否應上傳 Blob 資料的 ETag 比對條件。 preferredUploadBlockSize   _In_
類型:size_t
二進位 Blob 的慣用上傳區塊大小 (以位元組為單位)。如果二進位 Blob 超過此大小,將會以此大小分成多個區塊上傳。服務偏好較大的大小。如果發生逾時,應用程式應以較小的大小重試。區塊大小必須介於 1K 到 4MB 的範圍內。如果此參數不在可接受的範圍內,此方法會使用預設大小。目前的最小大小為 1024 個位元組,最大大小為 4194304 個位元組,預設大小為 262144 個位元組。(選用) async   _In_
類型:XAsyncBlock*
呼叫端配置的 AsyncBlock。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

REST 呼叫

V1 PUT json/users/xuid()/scids//data/,
V1 PUT global/scids//data/,
V1 PUT sessions//scids//data/,

需求

標頭: title_storage_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

title_storage_c
Last modified on October 6, 2026