MdlAfterReqCompletedReadA rule (kmdf)

The MdlAfterReqCompletedReadA rule specifies that within the EvtIoRead callback function, the memory descriptor list (MDL) object retrieved cannot be accessed after the I/O request is completed.

Within the driver's EvtIoRead callback function, the request buffer that was retrieved by calling the WdfRequestRetrieveOutputWdmMdl method cannot be accessed after calling WdfRequestComplete, WdfRequestCompleteWithInformation, or WdfRequestCompleteWithPriorityBoost on the I/O request.

This rule considers the following functions:

WDF_MEMORY_DESCRIPTOR_INIT_MDL

MmGetMdlByteCount

MmGetSystemAddressForMdlSafe

MmGetMdlVirtualAddress

IoBuildPartialMdl (first and second parameter)

KeFlushIoBuffers

MmGetMdlPfnArray

MmGetMdlByteOffset

MmPrepareMdlForReuse

WdfDmaTransactionInitialize

Driver modelKMDF

How to test

At compile time

Run Static Driver Verifier and specify the MdlAfterReqCompletedReadA rule.

Use the following steps to run an analysis of your code:
  1. Prepare your code (use role type declarations).
  2. Run Static Driver Verifier.
  3. View and analyze the results.

For more information, see Using Static Driver Verifier to Find Defects in Drivers.

Applies to

WDF_MEMORY_DESCRIPTOR_INIT_MDL
WdfDmaTransactionInitialize
WdfRequestComplete
WdfRequestCompleteWithInformation
WdfRequestCompleteWithPriorityBoost
WdfRequestRetrieveOutputWdmMdl
IoBuildPartialMdl
KeFlushIoBuffers
MmGetMdlByteCount
MmGetMdlByteOffset
MmGetMdlPfnArray
MmGetMdlVirtualAddress
MmGetSystemAddressForMdlSafe
MmPrepareMdlForReuse

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft