名称
VIDIOC_REQBUFS—开启内存映射或用户指针I/O函数
函数
int ioctl(int fd, int request, struct v4l2_requestbuffers *argp);指针
参数
fd:open()返回的文件描述符
request:VIDIOC_REQBUFS
argporm
描述
这个ioctl用于初始化内存映射或者用户指针IO,内存映射缓冲区由设备内存分配并且必须在应用程序地址空间分配以前由ioctl分配。用户空间的缓冲区由用户层本身分配,这个ioctl只是用来转换用户指针的一个驱动模块。
为分配设备缓冲区的应用程序初始化3个v4l2_requestbuffer结构,用type来区分流或者缓冲区,count是所需buffer数量,memory必须设置为v4l2_MEMORY_MMAP,当ioctl调用一个指针结构去驱动分配buffer数量并把这个数存在count中。当驱动运行的可用内存,请求的number能够更小甚至是0。当驱动正确调用函数请求更多的buffer,number也能够更大,当内存映射i/o不支持ioctl返回EINVAL。
应用程序能够重复调用VIDIOC_REQBUFS改变buffer数量,可是对于已经在映射的buffer不能成功。count值为0释放全部buffer,当全部DMA结束或退出,即VIDIOC_STEAMOFF。内存
struct v4l2_requestbuffers
__u32 count /*请求或获得的buffer数量,这个字段只能在memory设置为V4L2_MEMORY_MMAP后才能生效*/
enum v4l2_buf_type type /*stream或者buffer的类型,和v4l2_format结构的type字段相同,*/
enum v4l2_memory memory /*应用程序设置这个字段用来设置V4L2_MEMORY_MMAP 或 V4L2_MEMORY_USERPTR*/
__u32 reserved[2] /*留出扩展空间,定制buffer类型V4L2_BUF_TYPE_PRIVATE或更高*/io
返回值
成功返回0,出错返回-1且errno设为某特定值:
EBUSY
该驱动程序支持多种开放和I / O是已经在进行中,或试图从新分配的缓冲区,虽然仍有一个或多个映射。
EINVAL
缓冲区型(类型字段)或I / O请求方法(内存)不支持form