---
title: RetrieveFrameData
description: "该接口作为同步接口，用于获取一帧解码输出，拷贝数据时需要使用SetCopyFrameFunc提供的CopyFrame函数。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2530/armnative/kunpengcpsvideo_16_0077.html
sourcePath: /source/zh/kunpengboostkithistory/2530/armnative/kunpengcpsvideo_16_0077.html
indexId: 772169d2a8af078748a4ccdd7f7037509ab0bab59302e93331f5363db31477d877
---
# RetrieveFrameData

#### 函数功能

该接口作为同步接口，用于获取一帧解码输出，拷贝数据时需要使用SetCopyFrameFunc提供的CopyFrame函数。


#### 函数原型

DecoderRetCode RetrieveFrameData(uint8_t *buffer, uint32_t maxLen, uint32_t *filledLen)


#### 参数说明

| 字段名称 | 输入/输出 | 字段类型 | 字段描述 |
| --- | --- | --- | --- |
| buffer | 输入 | uint8\_t \* | 输出数据接收地址。 |


| 字段名称 | 输入/输出 | 字段类型 | 字段描述 |
| --- | --- | --- | --- |
| maxLen | 输入 | uint32\_t | 输出缓冲区最大长度。 |


| 字段名称 | 输入/输出 | 字段类型 | 字段描述 |
| --- | --- | --- | --- |
| filledLen | 输出 | uint32\_t \* | 输出数据的实际长度。 |


#### 返回值说明

数据类型：DecoderRetCode

取值如下：

- VIDEO_DECODER_SUCCESS：获取解码数据成功。
- VIDEO_DECODER_DECODE_FAIL：获取解码数据失败。
- VIDEO_DECODER_READ_UNDERFLOW：请求输出速度太快。