【Rockchip系列】官方函数：drm_buf_alloc
drm_buf_alloc 函数
功能
分配一个DRM（Direct Rendering Manager）缓冲区。
语法
void* drm_buf_alloc(int width, int height, int bpp, int* fd, int* handle, size_t* size, int flags);
参数
width: 缓冲区宽度（像素）height: 缓冲区高度（像素）bpp: 每像素位数fd: 指向整型的指针，用于存储分配的文件描述符handle: 指向整型的指针，用于存储分配的缓冲区句柄size: 指向size_t的指针，用于存储实际分配的缓冲区大小flags: 分配标志
描述
这个函数用于分配一个DRM缓冲区。它根据指定的宽度、高度和每像素位数创建一个适当大小的缓冲区，并返回相关的文件描述符、缓冲区句柄和实际大小。
返回值
- 成功时返回指向分配的缓冲区的指针（
void*类型） - 失败时返回
nullptr
注意事项
使用说明
- 在使用此函数之前，确保已包含必要的头文件（如
drm_alloc.h） - 需要正确处理返回的文件描述符、缓冲区句柄和缓冲区指针
- 使用完毕后，应当使用相应的释放函数（如
drm_buf_destroy）来释放分配的资源
示例用法
#include <iostream>
#include "drm_alloc.h"
#include "im2d.h"
#include "RgaUtils.h"int main() {int width = 1280;int height = 720;int format = RK_FORMAT_RGBA_8888;int bpp = get_bpp_from_format(format) * 8;int fd, handle;size_t size;int flags = 0;void* buf = drm_buf_alloc(width, height, bpp, &fd, &handle, &size, flags);if (buf == nullptr) {std::cerr << "Failed to allocate DRM buffer!" << std::endl;return -1;}std::cout << "DRM buffer allocated successfully:" << std::endl;std::cout << " FD: " << fd << std::endl;std::cout << " Handle: " << handle << std::endl;std::cout << " Size: " << size << " bytes" << std::endl;// 使用缓冲区...// 释放缓冲区drm_buf_destroy(fd, handle, buf, size);return 0;
}
示例输出
成功时:
pagesize is 4096
create width=1280, height=720, bpp=32, size=3686400 dumb buffer
out handle= 1
DRM buffer allocated successfully:FD: 4Handle: 1Size: 3686400 bytes
失败时:
Failed to allocate DRM buffer!
依赖
- DRM (Direct Rendering Manager) 库
- RGA 库（用于格式转换函数）
- C++ 标准库（用于输出）
相关函数
drm_buf_destroy: 用于释放通过drm_buf_alloc分配的缓冲区get_bpp_from_format: 用于从RGA格式获取每像素位数
这个文档提供了`drm_buf_alloc`函数的基本信息、用途、参数说明、返回值、使用注意事项和示例用法。它遵循了您之前提供的`imcheckHeader`函数文档的格式，并根据您给出的代码示例进行了适当的调整。