pxGetNetworkBufferWithDescriptor()
[以太网驱动程序移植 API]

NetworkBufferDescriptor_t *pxGetNetworkBufferWithDescriptor( size_t xRequestedSizeBytes,
                                                TickType_t xBlockTimeTicks );

		

发送到网络或从网络接收的数据 存储在网络缓冲区中。 网络缓冲区基本上只是一个 RAM 块（实际是源代码中的 uint8_t 数组）。

嵌入式 TCP/IP 堆栈需要首先定位网络缓冲区， 一旦定位就能知道网络缓冲区的大小。 网络缓冲区 描述符即用于此目的。

pucPayloadBuffer 指向网络缓冲区的起点。
xDataLength 保存缓冲区的大小（以字节为单位），不包括以太网 CRC 字节。

更多信息请参阅 网络缓冲区描述符描述如何移植 FreeRTOS-Plus-TCP 到新设备。

pxGetNetworkBufferWithDescriptor() 获取网络缓冲区和关联的网络缓冲区描述符。 如果 xRequestedSizeBytes 为 0，则自行获取网络缓冲区描述符， 而没有网络缓冲区。

不能从中断服务程序 (ISR) 调用 pxGetNetworkBufferWithDescriptor()。

网络缓冲区描述符的总数由 ipconfigNUM_NETWORK_BUFFER_DESCRIPTORS 设置。

参数：

返回：

若调用成功，则返回指向已获取的网络缓冲区描述符的指针 。 若调用失败，则返回 NULL。

用法示例：

有关示例，请参阅 将 FreeRTOS 移植到不同的微控制器 页面。