---
title: Recv
description: "接收对端发送的数据。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/armnative/kunpengcpsvideo_17_0027.html
sourcePath: /source/zh/kunpengboostkithistory/2300/armnative/kunpengcpsvideo_17_0027.html
indexId: eb87ccbd2697e0cce7bc8848a36b8579e34b5caf7c44f1a8d64695cc2b7f728477
---
# Recv

#### 函数功能

接收对端发送的数据。


#### 约束说明

视频流引擎要求二次开发者实现通信模块，用于数据的发送和接收。该函数是视频流引擎要求二次开发者在通信模块实现的外部符号，视频流引擎会调用该函数接收数据，需实现为阻塞式调用。


#### 函数原型

ssize_t Recv(int connection, uint8_t *buf, size_t len)


#### 参数说明

| 参数名称 | 输入/输出 | 参数类型 | 参数描述 |
| --- | --- | --- | --- |
| connection | 输入 | int | OnNewConnectionCallback返回的连接句柄。 |
| buf | 输入 | uint8\_t \* | 指向用于存放接收数据的内存指针。 |
| len | 输入 | size\_t | 用于存放接收数据的内存长度，不超过64KB。 |


#### 返回值说明

数据类型：ssize_t

取值如下：

- 大于0：实际接收到的数据字节数。
- -1：没有可接收的数据，可再次调用进行重试。
- -2：连接已经断开。