---
title: aclmdlSetDynamicBatchSize
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/aclcppdevg_03_0306.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg_03_0306.html
indexId: 79dbf879e0e054a9b5fccbf1d9eae8ae77ca4d58a00fb8b3833f0488f0c8bad272
---
# aclmdlSetDynamicBatchSize

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

在动态Batch场景下，在模型执行前调用本接口设置每次模型推理时处理图片的数量。


#### 函数原型

```
aclError aclmdlSetDynamicBatchSize(uint32_t modelId, aclmdlDataset *dataset, size_t index, uint64_t batchSize)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| modelId | 输入 | 模型ID。 调用aclmdlLoadFromFile接口/aclmdlLoadFromMem接口/aclmdlLoadFromFileWithMem接口/aclmdlLoadFromMemWithMem接口加载模型成功后，会返回模型ID。 |
| dataset | 输入&输出 | 模型推理的输入数据的指针。类型定义请参见aclmdlDataset。 使用aclmdlDataset类型的数据描述模型推理时的输入数据，输入的内存地址、内存大小用aclDataBuffer(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg\_03\_1430.html)类型的数据来描述。 |
| index | 输入 | 标识动态Batch输入的输入index，需调用aclmdlGetInputIndexByName接口获取，输入名称固定为ACL\_DYNAMIC\_TENSOR\_NAME。 |
| batchSize | 输入 | 每次模型推理时处理图片的数量。 此处设置的batch size只能是模型构建时设置的BatchSize档位中的某一档。 如果不清楚模型构建时的Batch档位设置，也可以调用aclmdlGetDynamicBatch接口获取指定模型支持的Batch档位数以及每一档中的batch size。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。


#### 接口调用示例

接口调用流程及示例，参见模型动态Shape输入推理(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/acldevg/aclcppdevg_000040.html)。