---
title: BioAllocCacheSpace
description: "申请缓存空间接口，该接口配合免拷贝写使用。"
url: https://www.hikunpeng.com/document/detail/zh/boostsds/BoostIO/kunpengboostIO_019.html
sourcePath: /source/zh/boostsds/BoostIO/kunpengboostIO_019.html
indexId: 65605d39468bf87b7fe62e90c424f01ee49e54984f3f22add984d7f43a13d4e151
---
# BioAllocCacheSpace

#### 函数定义

申请缓存空间接口，该接口配合免拷贝写使用。


#### 实现方法

CResult BioAllocCacheSpace(uint64_t tenantId, uint64_t objectId, uint64_t length, CacheSpaceDesc *space)


#### 参数说明


**表1 参数说明**

| 参数名 | 数据类型 | 参数类型 | 描述 |
| --- | --- | --- | --- |
| tenantId | uint64\_t | 入参 | 租户ID。 |
| objectId | uint64\_t | 入参 | 对象ID。 |
| length | uint64\_t | 入参 | 待申请缓存空间长度，最大值为4,194,304（4M）。 |
| space | CacheSpaceDesc\* | 出参 | 缓存空间信息描述： uint8\_t allocLoc; 申请标记。 uint16\_t addressNum; 地址数量。 uint16\_t descriptorSize; 缓存空间描述长度。 ObjLocation loc; 缓存空间位置。 CacheAddress address[CACHE\_SPACE\_ADDRESS\_SIZE]; 缓存空间地址信息： uint64\_t address; 缓存地址。 uint32\_t size; 缓存长度。 char descriptorInfo[CACHE\_SPACE\_DESC\_SIZE]; 缓存空间描述信息。 |


#### 返回值


**表2 返回值说明**

| 返回值 | 描述 |
| --- | --- |
| RET\_CACHE\_OK | 操作成功。 |
| RET\_CACHE\_NOT\_FOUND | Cache实例不存在。 |
| RET\_CACHE\_NOT\_READY | BoostIO服务未就绪。 |
| RET\_CACHE\_NEED\_RETRY | 需要外部重试。 |
| RET\_CACHE\_PT\_FAULT | 分区错误，对象位置无法写入。 |
| RET\_CACHE\_ERROR | 操作失败。 |