Export (0) Print
Expand All

KeRundownQueue routine

The KeRundownQueue routine cleans up a queue object, flushing any queued entries.

Syntax


PLIST_ENTRY KeRundownQueue(
  _Inout_ PRKQUEUE Queue
);

Parameters

Queue [in, out]

Pointer to an initialized queue object for which the caller provides resident storage in nonpaged pool.

Return value

If the queue is empty, KeRundownQueue returns NULL; otherwise, it returns the address of the first entry in the queue.

Remarks

File systems call KeRundownQueue to discard all entries from a queue before freeing or reusing the queue object.

If the queue object is to be reused, the caller must call KeInitializeQueue after calling KeRundownQueue, in order to reinitialize the queue object before reusing it.

KeRundownQueue returns no information about how many queued entries are discarded.

KeRundownQueue should never be called for a queue if any threads are waiting on the queue object.

For more information about using driver-managed internal queues, see Driver-Managed Queues.

Requirements

Target platform

Universal

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= DISPATCH_LEVEL

See also

KeInitializeQueue

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft