码迷,mamicode.com
首页 > 其他好文 > 详细

DeviceIoControl参数各个击破~!

时间:2014-06-10 15:10:00      阅读:173      评论:0      收藏:0      [点我收藏+]

标签:驱动开发   deviceiocontrol   设备驱动   

DeviceIoControl这个api我们用的不多,但是很重要,有时会帮助我们实现一些特别的需求, 如获取硬件设备信息、与硬件设备通信(读写数据)等,对照msdn,下面我们详细解释一下这个api的用法(有什么错误再所难免,各位不吝指教啊)。
DeviceIoControl是用来控制我们指定设备的输入输出操作,使设备按照我们发的指令去工作。

DeviceIoControl是kernel32中的函数,需要包含的头文件是winbase.h,先看函数原型

<strong>BOOL DeviceIoControl(
  HANDLE</strong> <em sizcache="28" sizset="62"><a target=_blank class="synParam" href="">hDevice</a></em><strong>, 
  DWORD</strong> <em sizcache="28" sizset="63"><a target=_blank class="synParam" href="">dwIoControlCode</a></em><strong>, 
  LPVOID</strong> <em sizcache="28" sizset="64"><a target=_blank class="synParam" href="">lpInBuffer</a></em><strong>, 
  DWORD</strong> <em sizcache="28" sizset="65"><a target=_blank class="synParam" href="">nInBufferSize</a></em><strong>, 
  LPVOID </strong><em sizcache="28" sizset="66"><a target=_blank class="synParam" href="">lpOutBuffer</a></em><strong>, 
  DWORD</strong> <em sizcache="28" sizset="67"><a target=_blank class="synParam" href="">nOutBufferSize</a></em><strong>, 
  LPDWORD</strong> <em sizcache="28" sizset="68"><a target=_blank class="synParam" href="">lpBytesReturned</a></em><strong>, 
  LPOVERLAPPED</strong> <em sizcache="28" sizset="69"><a target=_blank class="synParam" href="">lpOverlapped</a></em>
<strong>);</strong>

哈哈,参数不少,而且还都很抽象,没关系,我们一个一个击破它

来到第一个参数,hDevice,当然是要操作的设备的句柄了,这个句柄需要通过CreateFile的返回值中获取,对于createfile这里只做一个粗略的解释:

  • <strong>HANDLE CreateFile(
      LPCTSTR</strong> <em sizcache="28" sizset="70"><a target=_blank class="synParam" href="">lpFileName</a></em><strong>, 
      DWORD</strong> <em sizcache="28" sizset="71"><a target=_blank class="synParam" href="">dwDesiredAccess</a></em><strong>, 
      DWORD</strong> <em sizcache="28" sizset="72"><a target=_blank class="synParam" href="">dwShareMode</a></em><strong>, 
      LPSECURITY_ATTRIBUTES</strong> <em sizcache="28" sizset="73"><a target=_blank class="synParam" href="">lpSecurityAttributes</a></em><strong>, 
      DWORD</strong> <em sizcache="28" sizset="74"><a target=_blank class="synParam" href="">dwCreationDisposition</a></em><strong>, 
      DWORD</strong> <em sizcache="28" sizset="75"><a target=_blank class="synParam" href="">dwFlagsAndAttributes</a></em><strong>, 
      HANDLE</strong> <em sizcache="28" sizset="76"><a target=_blank class="synParam" href="">hTemplateFile</a></em>
    <strong>);</strong> 

参数:要打开的文件名,访问权限,共享模式,安全属性,文件存在与不存在时的文件创建模式,文件属性设定(隐藏、只读、压缩、指定为系统文件等),文件副本句柄。要说明的是第一个参数lpFileName,是设备的名称或者是和设备关连的驱动的名称,一般用\\.\DeviceName的形式,比如要打开逻辑驱动盘A就用\\.\a,也可以用\\.\PhysicalDevice0,\\.\PhsycalDebive1来指定物理驱动器,\\.\PhysicalDevice0表示本机的物理驱动器0(一般是主硬盘),从而来获取硬盘的序列号、模块名、扇区数、磁头数等相关信息

搞定hDevice!

dwIoControlCode: 当然就是控制设备的指令了,指令怎么来是个问题,微软已经定义好了很多种操作,在winioctl.h文件中,但最终都是通过CTL_CODE宏来实现的,其实这就是一种通信协议。CTL_CODE的具体用法在最后来介绍。

lpInBuffer: 设备操控请求数据的缓冲区基址,如果dwIoControlCode 指定了一个操作,该操作不需要输入数据,那么这个参数设为NULL

nInBufferSizelplnBuffer的size

lpOutBuffer:存放输出数据的buffer,同样,如果dwIoControlCode 指定了一个操作,该操作不需要处理输出数据,那么这个参数设为NULL

nOutBufferSizehaha,别说你不知道什么什么意思,pass

lpBytesReturned实际输出数据的bytes

lpOverlappedIgnored; set to NULL.(Are you understand?)

下面来到第二个参数的详解,CTL_CODE的定义与应用:

CTL_CODE原型:

<strong>#define CTL_CODE(</strong><em sizcache="28" sizset="88"><a target=_blank class="synParam" href="">DeviceType</a></em>, <em sizcache="28" sizset="89"><a target=_blank class="synParam" href="">Function</a></em>, <em sizcache="28" sizset="90"><a target=_blank class="synParam" href="">Method</a></em>, <em sizcache="28" sizset="91"><a target=_blank class="synParam" href="">Access</a></em><strong>) (
  ((</strong><em sizcache="28" sizset="92"><a target=_blank class="synParam" href="">DeviceType</a></em><strong>) << 16) | ((</strong><em sizcache="28" sizset="93"><a target=_blank class="synParam" href="">Access</a></em><strong>) << 14) | ((</strong><em sizcache="28" sizset="94"><a target=_blank class="synParam" href="">Function</a></em><strong>) << 2) | (</strong><em sizcache="28" sizset="95"><a target=_blank class="synParam" href="">Method</a></em><strong>)
)</strong>

可以看到,这个宏四个参数,自然是一个32位分成了4部分,高16位存储设备类型( 这里不列举了,看msdn哦),14~15位访问权限,2~13位操作功能,最后一个就是确定缓冲区(别忘记上面DeviceIOControl中缓冲区的定义哦)是如何与I/O和文件系统数据缓冲区进行数据传递的方式(具体取值查看msdn)我们最常用的就是METHOD_BUFFERED

Function codes 0-2047 are reserved for Microsoft; codes 2048-4095 are reserved for OEMs and IHVs. (我们能用的是2048~4095)

看以下一段:

这个宏经常用来定义IOCTL(I/O控制)和FSCTL(文件系统控制)功能控制代码,所有的IOCTLs必须通过这种方式定义,以确保这些指令能被Microsoft,以及其他的硬件厂商通信接口所识别

The following illustration shows the format of the resulting IOCTL.

 

援引微软定义的一个指令:锁卷

#define FSCTL_LOCK_VOLUME               CTL_CODE(FILE_DEVICE_FILE_SYSTEM,  6, METHOD_BUFFERED, FILE_ANY_ACCESS)

DeviceIoControl参数各个击破~!,布布扣,bubuko.com

DeviceIoControl参数各个击破~!

标签:驱动开发   deviceiocontrol   设备驱动   

原文地址:http://blog.csdn.net/feierwu/article/details/29572565

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!