---
title: hi_mpi_vi_get_pipe_frame
description: "获取VI物理PIPE的数据。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0841.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0841.html
indexId: 677a7af2d5292299e5ef7639679ae3be700c7179f737622e280cbcb8d9aa7eb5105
---
# hi_mpi_vi_get_pipe_frame

#### 函数功能

获取VI物理PIPE的数据。


#### 约束说明

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

- 调用  hi_mpi_vi_set_pipe_frame_dump_attr
接口开启dump、设置depth， 否则内部不会预留临时的内存空间，最终导致获取不到图像数据。
- 不支持虚拟PIPE。


#### 函数原型

hi_s32 hi_mpi_vi_get_pipe_frame(hi_vi_pipe vi_pipe, hi_video_frame_info *frame_info, hi_s32 milli_sec)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | 物理 PIPE 号。 取值范围：[0, 4) |
| frame\_info | 输出 | VI PIPE 数据信息的指针。 |
| milli\_sec | 输入 | 超时参数 ，取值范围： \-1：表示阻塞模式； 0：表示非阻塞模式； >0： 配置具体的超时时间，单位为毫秒（ms）。 |


#### 返回值说明

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


#### 参考资源

接口调用流程，参见视频数据获取功能。