Reference

RtlQueueWorkItem(3w)

NAME

RtlQueueWorkItem (NTDLL.@)

SYNOPSIS

NTSTATUS RtlQueueWorkItem
(
PRTL_WORK_ITEM_ROUTINE Function,
PVOID Context,
ULONG Flags
)

DESCRIPTION

Queues a work item into a thread in the thread pool.

PARAMS

Function [In] Work function to execute.

Context [In] Context to pass to the work function when it is executed.

Flags [In] Flags. See notes.

RETURNS

Success: STATUS_SUCCESS.

Failure: Any NTSTATUS code.

NOTES

Flags can be one or more of the following:
WT_EXECUTEDEFAULT - Executes the work item in a non-I/O worker thread.
WT_EXECUTEINIOTHREAD - Executes the work item in an I/O worker thread.
WT_EXECUTEINPERSISTENTTHREAD - Executes the work item in a thread that is persistent.
WT_EXECUTELONGFUNCTION - Hints that the execution can take a long time.
WT_TRANSFER_IMPERSONATION - Executes the function with the current access token.

IMPLEMENTATION

Declared in "winternl.h".

Implemented in "dlls/ntdll/threadpool.c".

Debug channel "threadpool".

History