Skip to main content

XblTitleStorageUploadBlobAsync

将 Blob 数据上传到标题存储。

语法

参数

xboxLiveContext   _In_
类型:XblContextHandle
使用 XblContextCreateHandle 创建的 XBOX Live 上下文句柄。 blobMetadata   _In_
类型:XblTitleStorageBlobMetadata
包含将缓冲区上传到标题存储所需的属性。上传至少需要一个服务配置 ID、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
最后修改于 2026年8月24日