---
title: hi_mpi_venc_request_idr
description: "请求IDR帧。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_1052.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_1052.html
indexId: f2bd647f6407c7da4cfbd4f565867796d932f2ff1aa2491a650e09e724a3a912105
---
# hi_mpi_venc_request_idr

#### 函数功能

请求IDR帧。


#### 约束说明

- 如果通道未创建，则返回失败。
- 接受IDR（Instantaneous Decoder Refresh）帧请求后，当instant=0时，则在帧率控制的下一帧编出IDR帧，当instant=1时，则立即编出IDR帧，不受帧率控制约束。
- IDR帧请求，只支持H.264/H.265编码协议。
- 由于目前的使用场景目标帧率与源帧率的值一致，所以此接口不受帧率控制影响当instant设置为0或1时，都是每调用一次接口即编出一个IDR，调用频繁会影响码流帧率和码率的稳定，使用时需要注意。
- 当GOP模式为Smartp或B帧模式（暂不支持B帧模式）下，请求IDR帧会延时生效。


#### 函数原型

hi_s32 hi_mpi_venc_request_idr(hi_venc_chn chn, hi_bool instant)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| chn | 输入 | 编码通道号。 Atlas 200/500 A2推理产品，编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。 |
| instant | 输入 | 是否使能立即编码IDR帧。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VENC视频编码/JPEGE图片编码返回码