流接口的详细参数
2011-09-02 09:17
183 查看
(1)、DWORD XXX_Open ( DWORD hDeviceContext,
DWORD AccessCode,
DWORD ShareMode )
参数:DWORD hDeviceContext,设备驱动的句柄,由XXX_Init函数创建式返回;
DWORD AccessCode,传给驱动程序使用的地址,这个地址跟读和写有关;
DWORD ShareMode,共享模式,
返回值:返回驱动程序引用实例句柄。
描述:这个函数用于打开一个设备驱动程序,当应用程序准备对某个设备进行读或写操作时,系统必须先执行CreateFile()这个函数用于打开这个设备,这个函数执行后才能执行读和写操作;
(2)、BOOL XXX_Close(DWORD hOpenContext)
参数:DWORD hOpenContext,设备驱动的句柄,由XXX_Open创建。
返回值:调用成功返回TRUE,失败返回FALSE
描述:这个函数用于关闭一个驱动程序的引用实例,应用程序通过CloseHandle()函数来调用这个函数,当执行完这个函数后,hOpenContext将不再有效;
(3)、DWORD XXX_Read(
DWORD hOpenContext,
LPVOID pBuffer,
DWORD Count)
参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;
LPVOID pBuffer,一个缓冲区地址,用于从驱动读数据;
DWORD Count,需要读缓冲区的长度
返回值:实际读缓冲区的长度
描述:当一个流式接口驱动程序已经打开后,可以使用ReadFile()函数对这个设备进行读操作。ReadFile()中的hFile参数对应设备的引用实例句柄hOpenContext,二参数lpBuffer将传给pBuffer,用于表示要读缓冲区的地址,参数nNumberOfByteToRead将传给Count,表示读取缓冲区的长度。
(4)、DWORD XXX_Write(
DWORD hOpenContext,
LPVOID pBuffer,
DWORD Count)
参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;
LPVOID pBuffer,一个缓冲区地址,用于从驱动写数据;
DWORD Count,需要写缓冲区的长度
返回值:实际写缓冲区的长度
描述:当一个流式接口驱动程序已经打开后,可以使用WriteFile()函数对这个设备进行写操作。
(5)、BOOL XXX_IOControl(DWORD hOpenContext,
WORD dwCode,
PBYTE pBufIn,
DWORD dwLenIn,
PBYTE pBufOut,
DWORD dwLenOut,
PDWORD pdwActualOut)
参数:DWORD hOpenContext,由CreateFile()函数返回的句柄;
WORD dwCode,用于描述这次IOControl操作的语义,由用户自己定义;
PBYTE pBufIn,缓冲区指针指向需要传送给驱动程序使用的数据;
DWORD dwLenIn,要传送给驱动程序使用数据的长度;
PBYTE pBufOu,缓冲区指针指向驱动程序传给应用程序使用的数据;
DWORD dwLenOut,要传送给应用程序使用数据的长度;
PDWORD pdwActualOut,返回实际处理数据的长度;
返回值:调用成功返回TRUE,失败返回FALSE
描述:这个函数通常用于向设备发送一个命令,应用程序使用DeviceIOControl函数来通知操作系统调用这个函数,通过参数dwCode来通知驱动程序要执行的操作。这个函数扩展了流式接口驱动程序的功能。
(6)、DWORD XXX_Init(DWORD dwContext)
参数:DWORD dwContext,指向字符串的指针,通常这个参数都为一个流式接口驱动在注册表内的设置。
返回值:如果调用成功返回一个驱动程序的句柄;
描述:当用户使用一个设备的时候,设备管理器调用这个函数来对设备进行初始化。这个函数并不是由应用程序调用的,而是通过设备管理器提供的ActiveDeviceEx()来调用。函数执行成功后返回一个设备的句柄。
相关文章推荐
- 规则 4.12:函数接口输出参数要对返回码进行详细描述,不同返回码独立成行,并左对齐。
- 架构设计--用户端全http参数接口详细说明v1
- 流接口的详细参数
- 架构设计--用户端全http参数接口详细说明v1
- 写接口请求类型为get或post的时,参数定义的几种方式,如何用注解(原创)--雷锋
- mysqldump参数详细说明
- VB ADODB中的RecordSet.Open打开记录的两个参数adOpenKeyset、adLockBatchOptimistic的详细说明
- PHP中$_SERVER的详细参数与说明
- Java中的参数传递与对象Clone详细讲解
- 详细解析Java中抽象类和接口的区别
- 配置文件lighttpd.conf参数详细说明的链接和选译
- java 中函数的参数传递详细介绍
- Using mysqldump for Backups(备份还原数据库实例及参数详细说明)
- soapui测试webservice接口时如何传递xml参数
- PHP中$_SERVER的详细参数与说明
- 《 window.open()的所有参数详细介绍 》
- 给一个接口传递参数,并接收返回的参数
- FPGA基础知识7(从芯片手册获取参数FPGA时序约束--“CMOS Sensor接口时序约束”)
- 【转】 nginx rewrite 伪静态配置参数详细说明
- 开放平台对外接口参数验证