明基扫描仪二次开发包教材.doc

明基扫描仪二次开发包教材 明基扫描仪二次开发包教材 PAGE / NUMPAGES 明基扫描仪二次开发包教材 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 明基扫描仪二次开发包 使用说明 明基电通讯息技术有限企业 ?营销总部 Page 1 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 目录 一，功能说明（ 3-3） 二，要求说明（ 3-3） 三，开发包文件结构说明（ 3-4） 四， 接口说明（ 4-15） 五， 接口说明（ 15-17） 附件：使用受权协议 明基 BenQ版权所有 2003 保存所有权益 . 所有内容若有变化，恕不另行通知 . 所有其余说起之品牌名称、 产品或企业名称的注册商标权归原企业所有 . Page 2 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 一． 功能说明 本开发包是为明基扫描仪特意供应的，能够让用户进行二次开发的开发包。该开发包是用 VC++ 开发的动向连结库 (scan.dll) 。接口简单，调用方便，让您能够在最短的时间内实现对明基 扫描仪的功能定制 。此外，本开发包还供应给用户明基自行开发的影像文件读写库 （ ）, 供应了多种影像格式的支持，让您能够方便的将扫描获得的影像数据存成各样格式（支持的文件 格式有 BMP, PCX, JPG, TIF, TGA, PNG ）的影像文件。本开发包内还附有开发例程，即便你一 点都不认识扫描仪的驱动过程， 也能在很短的时间里定制出切合你要求的应用程序（自然，你 需要有必定的 VC++编程能力） ， 比方说能在某个特定的地区内用特定的分辨率进行扫描。该例 程还供应了怎样使用汉王 OCR实现文字识其他演示。 二． 要求说明 此开发包需要配合明基供应之扫描仪设施以及设施驱动程序方可使用，使用前，请确认扫 描仪设施已经正确安装并工作。 三． 开发包文件结构说明 SDK: 根目录 \Include: 头文件目录（需要把该目录增添到你得 VC开发环境中） 的接口定义 ： 标准影像设施数据结构种类定义 ： 图像文件读写接口定义 \library: 库文件目录（需要把该目录增添到你得 VC开发环境中） ：图像文件读写接口库 \Src: 源文件目录 ： \Bin: 动向连结库目录 ： 扫描仪驱动接口动向连结库 图像文件读写动向连结库 \Sample: 例程目录 Page 3 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . VC++ 例程 \document: 说明文件目录 明基扫描仪开发包说明 .doc: 本说明文件 四． 接口说明 初始化函数 1. HINSTANCE InitTwainDLL(LPCTSTR szDLLName); 返回值 假如成功返回 的句柄，失败为 NULL。 参数 szDllName 指向 的绝对路径名 讲解 该接口函数一定第一个被调用成功，假如调用失败请检查路径名能否书写正确，或文件能否真的 存在。 2. VOID FreeTwainDLL(HINSTANCE hInst); 返回值 无 参数 hInst 的句柄。 讲解 该函数一定在程序推出时被调用，开释 资源。 Page 4 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 3. VOID NewTwain (Htwain * phTwain); 返回值 无 参数 phTwain 指向扫描仪句柄的指针 讲解 创立控制明基扫描仪的句柄 4. VOID FreeTwainDLL(HTwain hTwain); 返回值 无 参数 hTwain 扫描仪句柄 讲解 创立控制明基扫描仪的句柄 5. BOOL LoadSM (HTwain hTwain); 返回值 Page 5 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 成功 TRUE, 失败 FALSE 参数 hTwain 扫描仪句柄 讲解 载入驱动管理器 6. BOOL UnloadSM (HTwain hTwain); 返回值 成功 TRUE, 失败 FALSE 参数 hTwain 扫描仪句柄 讲解 卸载驱动管理器 7. BOOL OpenSM (HTwain hTwain); 返回值 成功 TRUE, 失败 FALSE 参数 hTwain 扫描仪句柄 讲解 翻开驱动管理器 8. BOOL CloseSM (HTwain hTwain); Page 6 of 18 20-2-20 明基 BenQ版权所有 2003 保存所有权益 . 返回值 成功 TRUE, 失败 FALSE 参数 hTwain 扫描仪句柄 讲解 封闭驱动管理器 9. B