3.2.5. 数字电视 mmap()¶
3.2.5.1. 名称¶
dmx-mmap - 将设备内存映射到应用程序地址空间
警告
此 API 仍处于实验阶段
3.2.5.2. 概要¶
#include <unistd.h>
#include <sys/mman.h>
-
void *mmap(void *start, size_t length, int prot, int flags, int fd, off_t offset)¶
3.2.5.3. 参数¶
start将缓冲区映射到应用程序地址空间中的此地址。当指定
MAP_FIXED标志时，start必须是页面大小的倍数，并且当无法使用指定的地址时，mmap 将失败。不鼓励使用此选项；应用程序只需在此处指定一个NULL指针即可。length要映射的内存区域的长度。这必须是 DVB 数据包长度的倍数（在大多数驱动程序上为 188）。
protprot参数描述所需的内存保护。无论设备类型和数据交换方向如何，都应将其设置为PROT_READ|PROT_WRITE，允许读取和写入图像缓冲区。驱动程序应至少支持此标志组合。flagsflags参数指定映射对象的类型、映射选项以及对页面映射副本所做的修改是进程私有的还是与其他引用共享的。MAP_FIXED请求驱动程序不选择指定的地址以外的任何其他地址。如果无法使用指定的地址，则mmap()将失败。如果指定了MAP_FIXED，则start必须是页面大小的倍数。不鼓励使用此选项。必须设置
MAP_SHARED或MAP_PRIVATE标志之一。MAP_SHARED允许应用程序与其他（例如，子）进程共享映射内存。注意
Linux 数字电视应用程序不应设置
MAP_PRIVATE、MAP_DENYWRITE、MAP_EXECUTABLE或MAP_ANON标志。fd由
open()返回的文件描述符。offset设备内存中缓冲区的偏移量，由 ioctl DMX_QUERYBUF ioctl 返回。
3.2.5.4. 描述¶
mmap() 函数请求将设备（由 fd 指定）内存中从 offset 开始的 length 个字节映射到应用程序地址空间中，最好是在地址 start 处。后一个地址只是一个提示，通常指定为 0。
合适的长度和偏移量参数通过 ioctl DMX_QUERYBUF ioctl 查询。缓冲区必须在使用之前通过 ioctl DMX_REQBUFS ioctl 分配。
要取消映射缓冲区，请使用 munmap() 函数。
3.2.5.5. 返回值¶
成功时，mmap() 返回指向映射缓冲区的指针。发生错误时，返回 MAP_FAILED (-1)，并相应地设置 errno 变量。可能的错误代码为
- EBADF
fd不是有效的文件描述符。- EACCES
fd未打开进行读取和写入。- EINVAL
start或length或offset不合适。（例如，它们太大，或者未在PAGESIZE边界上对齐。）不支持
flags或prot值。没有使用 ioctl DMX_REQBUFS ioctl 分配缓冲区。
- ENOMEM
没有足够的物理或虚拟内存来完成请求。