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

#### 产品支持情况

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


#### 功能说明

获取tensor描述中指定维度的范围，[1,-1]表示全shape范围。

当aclGetTensorDescNumDims接口的返回值为ACL_UNKNOWN_RANK时，表示动态Shape场景下维度个数未知，则不能调用aclGetTensorDescDimRange接口获取指定维度的范围。


#### 函数原型

```
aclError aclGetTensorDescDimRange(const aclTensorDesc *desc, size_t index, size_t dimRangeNum, int64_t *dimRange)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| desc | 输入 | aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。 |
| index | 输入 | 指定获取第几个维度的大小，index值从0开始。 用户调用aclGetTensorDescNumDims接口获取shape维度个数，这个Index的取值范围：[0, (shape维度个数\-1)]。 |
| dimRangeNum | 输入 | dimRange的长度，该值必须大于等于2。 |
| dimRange | 输出 | tensor描述中index指定维度的Shape范围。 dimRange是一个数组，数组的第一个元素值表示Shape范围的最小值，第二个元素值表示Shape范围的最大值。该数组中仅前2个元素值有效。 当dimRange数组的值为[1,\-1]时，表示全Shape范围。 |


#### 返回值说明

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