Function mmap_buffer

rustcv-camera/src/backend/linux/sys.rs:405–421

Memory-map a V4L2 buffer into user space. 将 V4L2 缓冲区内存映射到用户空间。 Uses `MAP_SHARED` so user space and kernel see the same physical memory (zero-copy). Uses `PROT_READ | PROT_WRITE` — read for frame data access, write for kernel DMA. 使用 `MAP_SHARED` 使用户空间和内核看到同一块物理内存（零拷贝）。 使用 `PROT_READ | PROT_WRITE` —— 读用于帧数据访问，写用于内核 DMA。

(fd: RawFd, length: usize, offset: u32)

/// 使用 `MAP_SHARED` 使用户空间和内核看到同一块物理内存（零拷贝）。
/// 使用 `PROT_READ | PROT_WRITE` —— 读用于帧数据访问，写用于内核 DMA。
pub fn mmap_buffer(fd: RawFd, length: usize, offset: u32) -> io::Result<*mut u8> {
    let ptr = unsafe {
        libc::mmap(
            std::ptr::null_mut(),
            length,
            libc::PROT_READ | libc::PROT_WRITE,
            libc::MAP_SHARED,
            fd,
            offset as libc::off_t,
        )
    };
    if ptr == libc::MAP_FAILED {
        Err(io::Error::last_os_error())
    } else {
        Ok(ptr as *mut u8)
    }
}

/// Unmap a previously mapped buffer.
/// 解除先前映射的缓冲区。