---
title: hi_mpi_vi_get_chn_attr
description: "获取VI通道属性。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0853.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0853.html
indexId: 365f6d3696e928f19dbf64f17cce1fd6c8e19aa7e81b59d4ec09fc3dd0247341105
---
# hi_mpi_vi_get_chn_attr

#### 函数功能

获取VI通道属性。


#### 约束说明

- 调用本接口前，必须先调用  hi_mpi_vi_create_pipe
接口创建PIPE。

- 必须先调用  hi_mpi_vi_set_chn_attr
接口设置通道属性。


#### 函数原型

hi_s32 hi_mpi_vi_get_chn_attr(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, hi_vi_chn_attr *chn_attr)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | PIPE号。 取值范围：[0, 8) |
| vi\_chn | 输入 | VI通道号。 取值范围：[0, 1) |
| chn\_attr | 输出 | VI通道属性结构体指针。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VI视频输入返回码
。
