DOC: InitializeListHead Function Documentation Is Incorrect

ID: Q196551

The information in this article applies to:

Microsoft Win32 Device Driver Kit (DDK) for Windows NT, versions 3.1, 3.5, 3.51, 4.0

SUMMARY

The following statement in the Comments section of the InitializeListHead function reference documentation is incorrect:

Callers of InitializeListHead must be running at IRQL PASSIVE_LEVEL.

Instead it should read:

Callers of InitializeListHead can be running at IRQL >= DISPATCH_LEVEL only if the caller-allocated storage for ListHead is resident and only if pointers to every list entry remain valid at IRQL >= DISPATCH_LEVEL as well.

Callers of this function must be running at IRQL PASSIVE_LEVEL if the storage for ListHead and pointers to every list entry are from PagedPool.

Keywords : kbdocerr kbDDK kbKMode kbNTOS310 kbNTOS350 kbNTOS351 kbNTOS400
Version : WINNT:3.1,3.5,3.51,4.0
Platform : winnt
Issue type : kbbug