Linux視頻設(shè)備驅(qū)動(dòng)常用控制命令使用說(shuō)明

　　設(shè)置視頻設(shè)備屬性通過(guò)ioctl來(lái)進(jìn)行設(shè)置，ioctl有三個(gè)參數(shù)，分別是fd， cmd，和parameter，表示設(shè)備描述符，控制命令和控制命令參數(shù)。

　　1. 控制命令VIDIOC_QUERYCAP

　　功能： 查詢(xún)?cè)O(shè)備驅(qū)動(dòng)的功能 ;

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的能力描述類(lèi)型struct v4l2_capability;

　　struct v4l2_capability {

　　__u8 driver［16］; /* i.e. “bttv” */ //驅(qū)動(dòng)名稱(chēng)，

　　__u8 card［32］; /* i.e. “Hauppauge WinTV” */ //

　　__u8 bus_info［32］; /* “PCI：” + pci_name（pci_dev） */ //PCI總線信息

　　__u32 version; /* should use KERNEL_VERSION（） */

　　__u32 capabilities; /* Device capabilities */ //設(shè)備能力

　　__u32 reserved［4］;

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;

　　函數(shù)執(zhí)行成功后，struct v4l2_capability 結(jié)構(gòu)體變量中的返回當(dāng)前視頻設(shè)備所支持的功能;

　　例如支持視頻捕獲功能V4L2_CAP_VIDEO_CAPTURE、 V4L2_CAP_STREAMING等。

　　使用舉例：

　　-------------------------------------------------------------------------------------------------------

　　struct v4l2_capability cap;

　　iret = ioctl（fd_usbcam， VIDIOC_QUERYCAP， &cap）;

　　if（iret 《 0）{

　　printf（“get vidieo capability error，error code： %d \n”， errno）;

　　return ;

　　}

　　------------------------------------------------------------------------------------------------------

　　執(zhí)行完VIDIOC_QUERYCAP命令后，cap變量中包含了該視頻設(shè)備的能力信息，程序中通過(guò)檢查cap中的設(shè)備能力信息來(lái)判斷設(shè)備是否支持某項(xiàng)功能。

　　2. 控制命令 VIDIOC_ENUM_FMT

　　功能： 獲取當(dāng)前視頻設(shè)備支持的視頻格式 。

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的視頻格式描述符類(lèi)型 struct v4l2_fmtdesc

　　struct v4l2_fmtdesc {

　　__u32 index; /* Format number */

　　enum v4l2_buf_type type; /* buffer type */

　　__u32 flags;

　　__u8 description［32］; /* Description string */

　　__u32 pixelformat; /* Format fourcc */

　　__u32 reserved［4］;

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;

　　struct v4l2_fmtdesc 結(jié)構(gòu)體中的 .pixelformat和 .description 成員返回當(dāng)前視頻設(shè)備所支持的視頻格式;

　　使用舉例：

　　-------------------------------------------------------------------------------------------------

　　struct v4l2_fmtdesc fmt;

　　memset（&fmt， 0， sizeof（fmt））;

　　fmt.index = 0;

　　fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　while （（ret = ioctl（dev， VIDIOC_ENUM_FMT， &fmt）） == 0）

　　{

　　fmt.index++;

　　printf（“{ pixelformat = ‘’%c%c%c%c‘’， description = ‘’%s‘’ }\n”，

　　fmt.pixelformat & 0xFF， （fmt.pixelformat 》》 8） & 0xFF， （fmt.pixelformat 》》 16） & 0xFF，

　　（fmt.pixelformat 》》 24） & 0xFF， fmt.description）;

　　}

　　-------------------------------------------------------------------------------------------------------

　　3. 控制命令VIDIOC_S_FMT

　　功能： 設(shè)置視頻設(shè)備的視頻數(shù)據(jù)格式，例如設(shè)置視頻圖像數(shù)據(jù)的長(zhǎng)、寬，圖像格式（JPEG、YUYV格式）;

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的視頻數(shù)據(jù)格式類(lèi)型 struct v4l2_format;

　　struct v4l2_format {

　　enum v4l2_buf_type type; //數(shù)據(jù)流類(lèi)型，必須永遠(yuǎn)是V4L2_BUF_TYPE_VIDEO_CAPTURE

　　union {

　　struct v4l2_pix_format pix; /* V4L2_BUF_TYPE_VIDEO_CAPTURE */

　　struct v4l2_window win; /* V4L2_BUF_TYPE_VIDEO_OVERLAY */

　　struct v4l2_vbi_format vbi; /* V4L2_BUF_TYPE_VBI_CAPTURE */

　　struct v4l2_sliced_vbi_format sliced; /* V4L2_BUF_TYPE_SLICED_VBI_CAPTURE */

　　__u8 raw_data［200］; /* user-defined */

　　} fmt;

　　};

　　struct v4l2_pix_format {

　　__u32 width; // 寬，必須是16的倍數(shù)

　　__u32 height; // 高，必須是16的倍數(shù)

　　__u32 pixelformat; // 視頻數(shù)據(jù)存儲(chǔ)類(lèi)型，例如是YUV4：2：2還是RGB

　　enum v4l2_field field;

　　__u32 bytesperline;

　　__u32 sizeimage;

　　enum v4l2_colorspace colorspace;

　　__u32 priv;

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;

　　使用舉例：

　　----------------------------------------------------------------------------------------------------------

　　struct v4l2_format tv4l2_format;

　　tv4l2_format.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　tv4l2_format.fmt.pix.width = img_width;

　　tv4l2_format.fmt.pix.height = img_height;

　　tv4l2_format.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;

　　tv4l2_format.fmt.pix.field = V4L2_FIELD_INTERLACED;

　　iret = ioctl（fd_usbcam， VIDIOC_S_FMT， &tv4l2_format）;

　　-----------------------------------------------------------------------------------------------------------

　　注意：如果該視頻設(shè)備驅(qū)動(dòng)不支持你所設(shè)定的圖像格式，視頻驅(qū)動(dòng)會(huì)重新修改struct v4l2_format結(jié)構(gòu)體變量的值為該視頻設(shè)備所支持的圖像格式，所以在程序設(shè)計(jì)中，設(shè)定完所

　　有的視頻格式后，要獲取實(shí)際的視頻格式，要重新讀取 struct v4l2_format結(jié)構(gòu)體變量。

　　使用VIDIOC_G_FMT設(shè)置視頻設(shè)備的視頻數(shù)據(jù)格式，VIDIOC_TRY_FMT驗(yàn)證視頻設(shè)備的視頻數(shù)據(jù)格式。

　　4. 控制命令VIDIOC_REQBUFS

　　功能： 請(qǐng)求V4L2驅(qū)動(dòng)分配視頻緩沖區(qū)（申請(qǐng)V4L2視頻驅(qū)動(dòng)分配內(nèi)存），V4L2是視頻設(shè)備的驅(qū)動(dòng)層，位于內(nèi)核空間，所以通過(guò)VIDIOC_REQBUFS控制命令字申請(qǐng)的內(nèi)存位于內(nèi)核空間，應(yīng)

　　用程序不能直接訪問(wèn)，需要通過(guò)調(diào)用mmap內(nèi)存映射函數(shù)把內(nèi)核空間內(nèi)存映射到用戶(hù)空間后，應(yīng)用程序通過(guò)訪問(wèn)用戶(hù)空間地址來(lái)訪問(wèn)內(nèi)核空間。

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的申請(qǐng)緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)體類(lèi)型struct v4l2_requestbuffers;

　　struct v4l2_requestbuffers {

　　u32 count; //緩存數(shù)量，也就是說(shuō)在緩存隊(duì)列里保持多少?gòu)堈掌?/p>

　　enum v4l2_buf_type type; //數(shù)據(jù)流類(lèi)型，必須永遠(yuǎn)是V4L2_BUF_TYPE_VIDEO_CAPTURE

　　enum v4l2_memory memory; //V4L2_MEMORY_MMAP或V4L2_MEMORY_USERPTR

　　u32 reserved［2］;

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0，V4L2驅(qū)動(dòng)層分配好了視頻緩沖區(qū);

　　使用舉例：

　　-----------------------------------------------------------------------------------------------------

　　struct v4l2_requestbuffers tV4L2_reqbuf;

　　memset（&tV4L2_reqbuf， 0， sizeof（struct v4l2_requestbuffers ））;

　　tV4L2_reqbuf.count = 1; //申請(qǐng)緩沖區(qū)的個(gè)數(shù)

　　tV4L2_reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　tV4L2_reqbuf.memory = V4L2_MEMORY_MMAP; //mmap方式

　　iret = ioctl（fd_usbcam， VIDIOC_REQBUFS， &tV4L2_reqbuf）;

　　-----------------------------------------------------------------------------------------------------

　　注意：VIDIOC_REQBUFS會(huì)修改tV4L2_reqbuf的count值，tV4L2_reqbuf的count值返回實(shí)際申請(qǐng)成功的視頻緩沖區(qū)數(shù)目;

　　5. 控制命令VIDIOC_QUERYBUF

　　功能： 查詢(xún)已經(jīng)分配的V4L2的視頻緩沖區(qū)的相關(guān)信息，包括視頻緩沖區(qū)的使用狀態(tài)、在內(nèi)核空間的偏移地址、緩沖區(qū)長(zhǎng)度等。在應(yīng)用程序設(shè)計(jì)中通過(guò)調(diào) VIDIOC_QUERYBUF來(lái)獲取內(nèi)

　　核空間的視頻緩沖區(qū)信息，然后調(diào)用函數(shù)mmap把內(nèi)核空間地址映射到用戶(hù)空間，這樣應(yīng)用程序才能夠訪問(wèn)位于內(nèi)核空間的視頻緩沖區(qū)。

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類(lèi)型 struct v4l2_buffer;

　　struct v4l2_buffer {

　　__u32 index;

　　enum v4l2_buf_type type;

　　__u32 bytesused;

　　__u32 flags;

　　enum v4l2_field field;

　　struct timeval timestamp;

　　struct v4l2_timecode timecode;

　　__u32 sequence;

　　/* memory location */

　　enum v4l2_memory memory;

　　union {

　　__u32 offset;

　　unsigned long userptr;

　　} m;

　　__u32 length;

　　__u32 input;

　　__u32 reserved;

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;

　　struct v4l2_buffer結(jié)構(gòu)體變量中保存了指令的緩沖區(qū)的相關(guān)信息;一般情況下，應(yīng)用程序中調(diào)用VIDIOC_QUERYBUF取得了內(nèi)核緩沖區(qū)信息后，緊接著調(diào)用mmap函數(shù)把內(nèi)核空間地址

　　映射到用戶(hù)空間，方便用戶(hù)空間應(yīng)用程序的訪問(wèn)。

　　使用舉例：

　　-------------------------------------------------------------------------------------------------------

　　struct v4l2_buffer tV4L2buf;

　　memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

　　tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　tV4L2buf.memory = V4L2_MEMORY_MMAP;

　　tV4L2buf.index = i; // 要獲取內(nèi)核視頻緩沖區(qū)的信息編號(hào)

　　iret = ioctl（fd_usbcam， VIDIOC_QUERYBUF， &tV4L2buf）;

　　// 把內(nèi)核空間緩沖區(qū)映射到用戶(hù)空間緩沖區(qū)

　　AppBufLength = tV4L2buf.length;

　　AppBufStartAddr = mmap（ NULL， /* start anywhere */

　　tV4L2buf.length，

　　PROT_READ | PROT_WRITE， /* access privilege */

　　MAP_SHARED， /* recommended */

　　fd_usbcam，

　　tV4L2buf.m.offset）;

　　-------------------------------------------------------------------------------------------------------

　　上述代碼在通過(guò)調(diào)用VIDIOC_QUERYBUF取得內(nèi)核空間的緩沖區(qū)信息后，接著調(diào)用mmap函數(shù)把內(nèi)核空間緩沖區(qū)映射到用戶(hù)空間;

　　6. 控制命令VIDIOC_QBUF

　　功能： 投放一個(gè)空的視頻緩沖區(qū)到視頻緩沖區(qū)輸入隊(duì)列中 ;

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類(lèi)型 struct v4l2_buffer;

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;

　　函數(shù)執(zhí)行成功后，指令（指定）的視頻緩沖區(qū)進(jìn)入視頻輸入隊(duì)列，在啟動(dòng)視頻設(shè)備拍攝圖像時(shí)，相應(yīng)的視頻數(shù)據(jù)被保存到視頻輸入隊(duì)列相應(yīng)的視頻緩沖區(qū)中。

　　使用舉例：

　　-------------------------------------------------------------------------------------------------------

　　struct v4l2_buffer tV4L2buf;

　　memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

　　tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　tV4L2buf.memory = V4L2_MEMORY_MMAP;

　　tV4L2buf.index = i; //指令（指定）要投放到視頻輸入隊(duì)列中的內(nèi)核空間視頻緩沖區(qū)的編號(hào);

　　iret = ioctl（fd_usbcam， VIDIOC_QBUF， &tV4L2buf）;

　　-------------------------------------------------------------------------------------------------------

　　7. 控制命令VIDIOC_DQBUF

　　功能： 從視頻緩沖區(qū)的輸出隊(duì)列中取得一個(gè)已經(jīng)保存有一幀視頻數(shù)據(jù)的視頻緩沖區(qū);

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2緩沖區(qū)數(shù)據(jù)結(jié)構(gòu)類(lèi)型 struct v4l2_buffer;

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，相應(yīng)的內(nèi)核視頻緩沖區(qū)中保存有當(dāng)前拍攝到的視頻數(shù)據(jù)，應(yīng)用程序可以通過(guò)訪問(wèn)用戶(hù)空間來(lái)讀取該視頻數(shù)據(jù)。（前面

　　已經(jīng)通過(guò)調(diào)用函數(shù) mmap做了用戶(hù)空間和內(nèi)核空間的內(nèi)存映射）。

　　使用舉例：

　　----------------------------------------------------------------------------------------------------------

　　struct v4l2_buffer tV4L2buf;

　　memset（&tV4L2buf， 0， sizeof（struct v4l2_buffer））;

　　tV4L2buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　tV4L2buf.memory = V4L2_MEMORY_MMAP;

　　iret = ioctl（fd_usbcam， VIDIOC_DQBUF， &tV4L2buf）;

　　-------------------------------------------------------------------------------------------------

　　說(shuō)明： VIDIOC_DQBUF命令結(jié)果， 使從隊(duì)列刪除的緩沖幀信息傳給了此tVL2buf。

　　V4L2_buffer結(jié)構(gòu)體的作用就相當(dāng)于申請(qǐng)的緩沖幀的代理，找緩沖幀的都要先問(wèn)問(wèn)它，通過(guò)它來(lái)聯(lián)系緩沖幀，起了中間橋梁的作用。

　　8. 控制命令VIDIOC_STREAMON

　　功能： 啟動(dòng)視頻采集命令，應(yīng)用程序調(diào)用VIDIOC_STREAMON啟動(dòng)視頻采集命令后，視頻設(shè)備驅(qū)動(dòng)程序開(kāi)始采集視頻數(shù)據(jù)，并把采集到的視頻數(shù)據(jù)保存到視頻驅(qū)動(dòng)的視頻緩沖區(qū)中。

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的視頻緩沖區(qū)類(lèi)型 enum v4l2_buf_type ;

　　enum v4l2_buf_type {

　　V4L2_BUF_TYPE_VIDEO_CAPTURE = 1，

　　V4L2_BUF_TYPE_VIDEO_OUTPUT = 2，

　　V4L2_BUF_TYPE_VIDEO_OVERLAY = 3，

　　V4L2_BUF_TYPE_VBI_CAPTURE = 4，

　　V4L2_BUF_TYPE_VBI_OUTPUT = 5，

　　V4L2_BUF_TYPE_SLICED_VBI_CAPTURE = 6，

　　V4L2_BUF_TYPE_SLICED_VBI_OUTPUT = 7，

　　#if 1

　　/* Experimental */

　　V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY = 8，

　　#endif

　　V4L2_BUF_TYPE_PRIVATE = 0x80，

　　};

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，視頻設(shè)備驅(qū)動(dòng)程序開(kāi)始采集視頻數(shù)據(jù)，此時(shí)應(yīng)用程序一般通過(guò)調(diào)用select函數(shù)來(lái)判斷一幀視頻數(shù)據(jù)是否采集完成，

　　當(dāng)視頻設(shè)備驅(qū)動(dòng)完成一幀視頻數(shù)據(jù)采集并保存到視頻緩沖區(qū)中時(shí)，select函數(shù)返回，應(yīng)用程序接著可以讀取視頻數(shù)據(jù);否則select函數(shù)阻塞直到視頻數(shù)據(jù)采集完成。 Select函數(shù)的

　　使用請(qǐng)讀者參考相關(guān)資料。

　　使用舉例：

　　----------------------------------------------------------------------------------------------------------

　　enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　fd_set fds ;

　　struct timeval tv;

　　iret = ioctl（fd_usbcam， VIDIOC_STREAMON， &v4l2type）;

　　FD_ZERO（&fds）;

　　FD_SET（fd_usbcam， &fds）;

　　tv.tv_sec = 2; /* Timeout. */

　　tv.tv_usec = 0;

　　iret = select（fd_usbcam+ 1， &fds， NULL， NULL， &tv）;

　　----------------------------------------------------------------------------------------------------------

　　9. 控制命令VIDIOC_STREAMOFF

　　功能： 停止視頻采集命令，應(yīng)用程序調(diào)用VIDIOC_ STREAMOFF停止視頻采集命令后，視頻設(shè)備驅(qū)動(dòng)程序不在采集視頻數(shù)據(jù)。

　　參數(shù)說(shuō)明：參數(shù)類(lèi)型為V4L2的視頻緩沖區(qū)類(lèi)型 enum v4l2_buf_type;

　　返回值說(shuō)明： 執(zhí)行成功時(shí)，函數(shù)返回值為 0;函數(shù)執(zhí)行成功后，視頻設(shè)備停止采集視頻數(shù)據(jù)。

　　使用舉例：

　　----------------------------------------------------------------------------------------------------------

　　enum v4l2_buf_type v4l2type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　iret = ioctl（fd_usbcam， VIDIOC_STREAMOFF， &v4l2type）;

　　-----------------------------------------------------------------------------------------------------------

　　10. 控制命令VIDIOC_QUERYSTD

　　功能：在亞洲，一般使用PAL（720X576）制式的攝像頭，而歐洲一般使用NTSC（720X480），使用VIDIOC_QUERYSTD來(lái)檢測(cè)：

　　參數(shù)說(shuō)明：

　　返回值說(shuō)明：

　　typedef __u64 v4l2_std_id;

　　使用舉例：

　　-----------------------------------------------------------------------------------------------------------

　　v4l2_std_id std;

　　do{

　　ret= ioctl（fd， VIDIOC_QUERYSTD， &std）;

　　} while（ret== -1 && errno== EAGAIN）;

　　switch（std） {

　　caseV4L2_STD_NTSC：

　　//……

　　caseV4L2_STD_PAL：

　　//……

　　}

　　-----------------------------------------------------------------------------------------------------------

　　以上就是Linux 視頻設(shè)備驅(qū)動(dòng)V4L2最常用的控制命令使用說(shuō)明，通過(guò)使用以上控制命令，可以完成一幅視頻數(shù)據(jù)的采集過(guò)程。

　　V4L2更多的控制命令使用說(shuō)明請(qǐng)參考：http://v4l2spec.bytesex.org/spec/book1.htm

　　下面是damo程序（經(jīng)過(guò)實(shí)際驗(yàn)證，修改了網(wǎng)上的例程的錯(cuò)誤）

　　-----------------------------------------------------------------------------------------------------------

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#include

　　#define CAMERA_DEVICE “/dev/video0”

　　#define CAPTURE_FILE “frame.jpg”

　　#define VIDEO_WIDTH 640

　　#define VIDEO_HEIGHT 480

　　#define VIDEO_FORMAT V4L2_PIX_FMT_YUYV

　　#define BUFFER_COUNT 4

　　typedef struct VideoBuffer {

　　void *start;

　　size_t length;

　　} VideoBuffer;

　　VideoBuffer framebuf［BUFFER_COUNT］; //修改了錯(cuò)誤，2012-5.21

　　int main（）

　　{

　　int i， ret;

　　// 打開(kāi)設(shè)備

　　int fd;

　　fd = open（CAMERA_DEVICE， O_RDWR， 0）;

　　if （fd 《 0） {

　　printf（“Open %s failed\n”， CAMERA_DEVICE）;

　　return -1;

　　}

　　// 獲取驅(qū)動(dòng)信息

　　struct v4l2_capability cap;

　　ret = ioctl（fd， VIDIOC_QUERYCAP， &cap）;

　　if （ret 《 0） {

　　printf（“VIDIOC_QUERYCAP failed （%d）\n”， ret）;

　　return ret;

　　}

　　// Print capability infomations

　　printf（“Capability Informations：\n”）;

　　printf（“ driver： %s\n”， cap.driver）;

　　printf（“ card： %s\n”， cap.card）;

　　printf（“ bus_info： %s\n”， cap.bus_info）;

　　printf（“ version： %08X\n”， cap.version）;

　　printf（“ capabilities： %08X\n”， cap.capabilities）;

　　// 設(shè)置視頻格式

　　struct v4l2_format fmt;

　　memset（&fmt， 0， sizeof（fmt））;

　　fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　fmt.fmt.pix.width = VIDEO_WIDTH;

　　fmt.fmt.pix.height = VIDEO_HEIGHT;

　　fmt.fmt.pix.pixelformat = V4L2_PIX_FMT_YUYV;

　　fmt.fmt.pix.field = V4L2_FIELD_INTERLACED;

　　ret = ioctl（fd， VIDIOC_S_FMT， &fmt）;

　　if （ret 《 0） {

　　printf（“VIDIOC_S_FMT failed （%d）\n”， ret）;

　　return ret;

　　}

　　// 獲取視頻格式

　　ret = ioctl（fd， VIDIOC_G_FMT， &fmt）;

　　if （ret 《 0） {

　　printf（“VIDIOC_G_FMT failed （%d）\n”， ret）;

　　return ret;

　　}

　　// Print Stream Format

　　printf（“Stream Format Informations：\n”）;

　　printf（“ type： %d\n”， fmt.type）;

　　printf（“ width： %d\n”， fmt.fmt.pix.width）;

　　printf（“ height： %d\n”， fmt.fmt.pix.height）;

　　char fmtstr［8］;

　　memset（fmtstr， 0， 8）;

　　memcpy（fmtstr， &fmt.fmt.pix.pixelformat， 4）;

　　printf（“ pixelformat： %s\n”， fmtstr）;

　　printf（“ field： %d\n”， fmt.fmt.pix.field）;

　　printf（“ bytesperline： %d\n”， fmt.fmt.pix.bytesperline）;

　　printf（“ sizeimage： %d\n”， fmt.fmt.pix.sizeimage）;

　　printf（“ colorspace： %d\n”， fmt.fmt.pix.colorspace）;

　　printf（“ priv： %d\n”， fmt.fmt.pix.priv）;

　　printf（“ raw_date： %s\n”， fmt.fmt.raw_data）;

　　// 請(qǐng)求分配內(nèi)存

　　struct v4l2_requestbuffers reqbuf;

　　reqbuf.count = BUFFER_COUNT;

　　reqbuf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　reqbuf.memory = V4L2_MEMORY_MMAP;

　　ret = ioctl（fd ， VIDIOC_REQBUFS， &reqbuf）;

　　if（ret 《 0） {

　　printf（“VIDIOC_REQBUFS failed （%d）\n”， ret）;

　　return ret;

　　}

　　// 獲取空間

　　VideoBuffer* buffers = calloc（ reqbuf.count， sizeof（*buffers） ）;

　　struct v4l2_buffer buf;

　　for （i = 0; i 《 reqbuf.count; i++）

　　{

　　buf.index = i;

　　buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　buf.memory = V4L2_MEMORY_MMAP;

　　ret = ioctl（fd ， VIDIOC_QUERYBUF， &buf）;

　　if（ret 《 0） {

　　printf（“VIDIOC_QUERYBUF （%d） failed （%d）\n”， i， ret）;

　　return ret;

　　}

　　// mmap buffer

　　framebuf［i］.length = buf.length;

　　framebuf［i］.start = （char *） mmap（0， buf.length， PROT_READ|PROT_WRITE， MAP_SHARED， fd， buf.m.offset）;

　　if （framebuf［i］.start == MAP_FAILED） {

　　printf（“mmap （%d） failed： %s\n”， i， strerror（errno））;

　　return -1;

　　}

　　// Queen buffer

　　ret = ioctl（fd ， VIDIOC_QBUF， &buf）;

　　if （ret 《 0） {

　　printf（“VIDIOC_QBUF （%d） failed （%d）\n”， i， ret）;

　　return -1;

　　}

　　printf（“Frame buffer %d： address=0x%x， length=%d\n”， i， （unsigned int）framebuf［i］.start， framebuf［i］.length）;

　　}

　　// 開(kāi)始錄制

　　enum v4l2_buf_type type = V4L2_BUF_TYPE_VIDEO_CAPTURE;

　　ret = ioctl（fd， VIDIOC_STREAMON， &type）;

　　if （ret 《 0） {

　　printf（“VIDIOC_STREAMON failed （%d）\n”， ret）;

　　return ret;

　　}

　　// Get frame

　　ret = ioctl（fd， VIDIOC_DQBUF， &buf）;

　　if （ret 《 0） {

　　printf（“VIDIOC_DQBUF failed （%d）\n”， ret）;

　　return ret;

　　}

　　// Process the frame

　　FILE *fp = fopen（CAPTURE_FILE， “wb”）;

　　if （fp 《 0） {

　　printf（“open frame data file failed\n”）;

　　return -1;

　　}

　　fwrite（framebuf［buf.index］.start， 1， buf.length， fp）;

　　fclose（fp）;

　　printf（“Capture one frame saved in %s\n”， CAPTURE_FILE）;

　　// Re-queen buffer

　　ret = ioctl（fd， VIDIOC_QBUF， &buf）;

　　if （ret 《 0） {

　　printf（“VIDIOC_QBUF failed （%d）\n”， ret）;

　　return ret;

　　}

　　// Release the resource

　　for （i=0; i《 4; i++）

　　{

　　munmap（framebuf［i］.start， framebuf［i］.length）;

　　}

　　close（fd）;

　　printf（“Camera test Done.\n”）;

　　return 0;

　　}

　　-----------------------------------------------------------------------------------------------------------

　　附件：

　　void *mmap（void *start， size_t length， int prot， int flags， int fd， off_t offset）;

　　int munmap（void *start， size_t length）;

　　參數(shù)說(shuō)明：

　　——start：映射區(qū)的開(kāi)始地址。

　　——length：映射區(qū)的長(zhǎng)度。

　　——prot：期望的內(nèi)存保護(hù)標(biāo)志，不能與文件的打開(kāi)模式?jīng)_突。是以下的某個(gè)值，可以通過(guò)or運(yùn)算合理地組合在一起

　　—PROT_EXEC //頁(yè)內(nèi)容可以被執(zhí)行

　　—PROT_READ //頁(yè)內(nèi)容可以被讀取

　　—PROT_WRITE //頁(yè)可以被寫(xiě)入

　　—PROT_NONE //頁(yè)不可訪問(wèn)

　　——flags：指定映射對(duì)象的類(lèi)型，映射選項(xiàng)和映射頁(yè)是否可以共享。它的值可以是一個(gè)或者多個(gè)以下位的組合體

　　—MAP_FIXED //使用指定的映射起始地址，如果由start和len參數(shù)指定的內(nèi)存區(qū)重疊于現(xiàn)存的映射空間，重疊部分將會(huì)被丟棄。如果指定的起始地址不可用，操作將會(huì)失

　　敗。并且起始地址必須落在頁(yè)的邊界上。

　　—MAP_SHARED //與其它所有映射這個(gè)對(duì)象的進(jìn)程共享映射空間。對(duì)共享區(qū)的寫(xiě)入，相當(dāng)于輸出到文件。直到msync（）或者munmap（）被調(diào)用，文件實(shí)際上不會(huì)被更新。

　　—MAP_PRIVATE //建立一個(gè)寫(xiě)入時(shí)拷貝的私有映射。內(nèi)存區(qū)域的寫(xiě)入不會(huì)影響到原文件。這個(gè)標(biāo)志和以上標(biāo)志是互斥的，只能使用其中一個(gè)。

　　—MAP_DENYWRITE //這個(gè)標(biāo)志被忽略。

　　—MAP_EXECUTABLE //同上

　　—MAP_NORESERVE //不要為這個(gè)映射保留交換空間。當(dāng)交換空間被保留，對(duì)映射區(qū)修改的可能會(huì)得到保證。當(dāng)交換空間不被保留，同時(shí)內(nèi)存不足，對(duì)映射區(qū)的修改會(huì)引起

　　段違例信號(hào)。

　　—MAP_LOCKED //鎖定映射區(qū)的頁(yè)面，從而防止頁(yè)面被交換出內(nèi)存。

　　—MAP_GROWSDOWN //用于堆棧，告訴內(nèi)核VM系統(tǒng)，映射區(qū)可以向下擴(kuò)展。

　　—MAP_ANONYMOUS //匿名映射，映射區(qū)不與任何文件關(guān)聯(lián)。

　　—MAP_ANON //MAP_ANONYMOUS的別稱(chēng)，不再被使用。

　　—MAP_FILE //兼容標(biāo)志，被忽略。

　　—MAP_32BIT //將映射區(qū)放在進(jìn)程地址空間的低2GB，MAP_FIXED指定時(shí)會(huì)被忽略。當(dāng)前這個(gè)標(biāo)志只在x86-64平臺(tái)上得到支持。

　　—MAP_POPULATE //為文件映射通過(guò)預(yù)讀的方式準(zhǔn)備好頁(yè)表。隨后對(duì)映射區(qū)的訪問(wèn)不會(huì)被頁(yè)違例阻塞。

　　—MAP_NONBLOCK //僅和MAP_POPULATE一起使用時(shí)才有意義。不執(zhí)行預(yù)讀，只為已存在于內(nèi)存中的頁(yè)面建立頁(yè)表入口。

　　——fd：有效的文件描述詞。如果MAP_ANONYMOUS被設(shè)定，為了兼容問(wèn)題，其值應(yīng)為-1。

　　——offset：被映射對(duì)象內(nèi)容的起點(diǎn)。

　　返回值：

　　成功執(zhí)行時(shí)，mmap（）返回被映射區(qū)的指針，munmap（）返回0。

　　失敗時(shí)，mmap（）返回MAP_FAILED［其值為（void *）-1］，munmap返回-1。errno被設(shè)為以下的某個(gè)值。