FVID 函数: FVID_create()作用:是分配并初始化FVID通道对象; 语法:fvidChan = FVID_create (name, mode, *status, optArgs, *attrs); 参数定义:
String name /* handle to an instance of the device */ Int mode /* pointer to buffer allocated by driver */ Int *status /* pointer to size of buffer pointed to by */ Ptr optArgs /* */ FVID_Attrs *attrs /* */ 其中: name是设备实例的句柄,是一个字符串mode 是选择的模式,只有两个值:IOM_INPUT 设置采集模式,IOM_OUTPUT设置显示模式。 status是由下层mini driver返回的状态值。 attrs 是指向FVID_Attrs结构的指针: FVID_Attrs的定义如下: typedef struct FVID_Attrs { Uns timeout; } FVID_Attrs; timeout成员用来指定旗语同步,它的值可以是: SYS_FOREVER:会让FVID_alloc, FVID_free and FVID_exchange的调用不确定的等待到这个调用完成. 数字的timeout值会让这些APIs阻塞一段指定的时间(以系统时钟). 0值会让APIs不阻塞,他们会立刻返回,这种情况下,应用程序会检查返回的status值来保证调用已经成功完成. 备注:FVID_alloc, FVID_free 和 FVID_exchange 的调用只能在 DSP/BIOS task (TSK). FVID_create的返回值: 如果通道成功的打开了,那么FVID_create返回一个指向通道的句柄.这个句柄可以用来让后来的模块调用这个通道. 实列:
/* Initialize the attributes */ FVID_ATTRS dispAttrs = FVID_ATTRS; /* Create an instance to a video display device */ chan- Handle = FVID_create(“\display0”, IOM_INPUT, NULL, NULL,&dispAttrs); |