DispatchReadWrite in Higher-Level Drivers

Except for file system drivers, a higher-level driver usually does not have any internal driver queues for IRPs. Such a driver's DispatchReadWrite routine can pass IRPs with valid parameters on to lower drivers, possibly after setting up its IoCompletion routine, as described in Passing IRPs down the Driver Stack.

However, a SCSI class driver's DispatchReadWrite routine is responsible for splitting up large transfer requests, if necessary, before it sends an IRP with the major function code IRP_MJ_READ or IRP_MJ_WRITE to the SCSI port/miniport driver pair. For more information, see Storage Class Driver's SplitTransferRequest Routine.

If a higher-level driver allocates one or more IRPs, which it sets up for the next-lower driver in its DispatchReadWrite routine, to request some number of partial transfers, the DispatchReadWrite routine must call IoSetCompletionRoutine with each driver-allocated IRP. The driver must register its IoCompletion routine to track how much data is transferred in each partial-transfer operation so that the IoCompletion routine can release all driver-allocated IRPs and, eventually, complete the original request.

If the underlying driver controls a removable-media device, any IRPs allocated by the higher-level driver must have a thread context. To set up a thread context, the allocating driver must set the Irp->Tail.Overlay.Thread in each newly allocated IRP from the same value in the incoming transfer IRP. For more information, see Supporting Removable Media.

If the underlying device driver returns an IRP for a partial transfer with an error, the IoCompletion routine can either retry the partial-transfer request or complete the original IRP with its I/O status block set with the returned error, after freeing any IRPs and memory the higher-level driver has allocated.

If a higher-level driver's DispatchReadWrite routine allocates memory for partial-transfer operations and its allocation will be accessed by the driver's IoCompletion routine (or by the underlying device driver), the DispatchReadWrite routine must allocate that memory from nonpaged pool.



Send comments about this topic to Microsoft