【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: 4
  Handle: 1
  Size: 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`函数文档的格式，并根据您给出的代码示例进行了适当的调整。