Windows驱动开发(9) - IRP结构体

Windows驱动开发(9) - IRP结构体

typedef struct _IRP {
  PMDL              MdlAddress;
  ULONG             Flags;
  union {
    struct _IRP*   MasterIrp;
    PVOID          SystemBuffer;
  } AssociatedIrp;
  IO_STATUS_BLOCK   IoStatus;
  KPROCESSOR_MODE   RequestorMode;
  BOOLEAN           PendingReturned;
  BOOLEAN           Cancel;
  KIRQL             CancelIrql;
  PDRIVER_CANCEL    CancelRoutine;
  PVOID             UserBuffer;
  union {
    struct {
      union {
        KDEVICE_QUEUE_ENTRY DeviceQueueEntry;
        struct {
          PVOID    DriverContext[4];
        };
      };
      PETHREAD     Thread;
      LIST_ENTRY   ListEntry;
    } Overlay;
  } Tail;
} IRP, *PIRP;

• MdlAddress：设备执行直接I/O时，指向用户空间的内存描述表
• ULONG Flags：包含一些对驱动程序只读的标志。但这些标志与WDM驱动程序无关
• AssociatedIrp.SystemBuffer：SystemBuffer指针指向一个数据缓冲区，该缓冲区位于内核模式的非分页内存中I/O管理器把用户模式程序发送给驱动程序的数据复制到这个缓冲区，这也是创建IRP过程的一部分。对于读请求，设备驱动程序把读出的数据填到这个缓冲区，然后I/O管理器再把缓冲区的内容复制到用户模式缓冲区。
• IoStatus：是一个结构体IO_STATUS_BLOCK, 这个结构体仅包含两个域，驱动程序在最终完成请求时设置这个结构。
  
  • IoStatus.Status : 将收到一个NTSTATUS代码。
  • IoStatus.Information 的类型为ULONG_PTR，它将收到一个信息值，该信息值的确切含义要取决于具体的IRP类型和请求完成的状态。Information域的一个公认用法是用于保存数据传输操作。某些PnP请求把这个域作为指向另外一个结构的指针，这个结构通常包含查询请求的结果。
• RequestorMode：将等于一个枚举常量UserMode或KernelMode，指定原始I/O请求的来源。驱动程序有时需要查看这个值来决定是否要信任某些参数。
• PendingReturned(BOOLEAN)：如果为TRUE，则表明处理该IRP的最低级派遣例程返回了STATUS_PENDING。完成例程通过参考该域来避免自己与派遣例程间的潜在竞争。
• Cancel(BOOLEAN)：如果为TRUE，则表明IoCancelIrp已被调用，该函数用于取消这个请求。如果为FALSE，则表明没有调用IoCancelIrp函数。
• CancelIrql(KIRQL)：是一个IRQL值，表明那个专用的取消自旋锁是在这个IRQL上获取的。当你在取消例程中释放自旋锁时应参考这个域。
• CancelRoutine(PDRIVER_CANCEL)：是驱动程序取消例程的地址。你应该使用IoSetCancelRoutine函数设置这个域而不是直接修改该域。
• UserBuffer(PVOID)：对于METHOD_NEITHER方式的IRP_MJ_DEVICE_CONTROL请求，该域包含输出缓冲区的用户模式虚拟地址。该域还用于保存读写请求缓冲区的用户模式虚拟地址，但指定了DO_BUFFERED_IO或DO_DIRECT_IO标志的驱动程序，其读写例程通常不需要访问这个域。当处理一个METHOD_NEITHER控制操作时，驱动程序能用这个地址创建自己的MDL。

Tail.Overlay.DeviceQueueEntry
If IRPs are queued in the device queue associated with the driver’s device object, this field links IRPs in the device queue. These links can be used only while the driver is processing the IRP.

Tail.Overlay.DriverContext
If IRPs are not queued in the device queue associated with the driver’s device object, this field can be used by the driver to store up to four pointers. This field can be used only while the driver owns the IRP.

Tail.Overlay.Thread
A pointer to the caller’s thread control block (TCB). For requests that originate in user-mode, the I/O manager always sets this field to point to the TCB of the thread that issued the request.

Tail.Overlay.ListEntry
If a driver manages its own internal queues of IRPs, it uses this field to link one IRP to the next. These links can be used only while the driver is holding the IRP in its queue or is processing the IRP.