DOC: MmCreateMdl Function Documentation Is Incorrect

ID: Q200192

The information in this article applies to:

Microsoft Win32 Device Driver Kit (DDK) for Windows NT

SUMMARY

The comments section of the MmCreateMdl function reference documentation should read:

"The caller must be running at IRQL <= DISPATCH_LEVEL, if the caller passes a NULL pointer for MemoryDescriptorList and expects MmCreateMdl to allocate the storage. The system allocates storage from NonPagedPoolMustSucceed memory pool."

If the call to MmCreateMdl occurs while running at IRQL > DISPATCH_LEVEL, the caller must allocate memory for the MDL from nonpaged pool and must supply a pointer for MemoryDescriptorList.

This function has been made obsolete in Windows 2000 and therefore the callers should use IoAllocateMdl instead. NOTE: Editor change to Public when Windows 2000 is released.

Additional query words: kbDSupport


Keywords          : kbDDK kbKMode kbNTOS400 
Version           : winnt:
Platform          : winnt 
Issue type        :

Last Reviewed: April 20, 1999