// ntifs.h
VOID KeStackAttachProcess(
PRKPROCESS PROCESS,
[out] PRKAPC_STATE ApcState
);
View the official Windows Driver Kit DDI referenceNo description available.
The KeStackAttachProcess routine attaches the current thread to the address space of the target process.
Caution Use this routine with extreme caution. (See the note in the Remarks section.)
PROCESSPointer to the target process object. This parameter can be a PEPROCESS pointer returned by IoGetCurrentProcess or PsGetCurrentProcess.
ApcState [out]An opaque pointer to a KAPC_STATE structure. The caller must allocate storage for this structure either from nonpaged pool or from the caller's own thread stack.
KeStackAttachProcess attaches the current thread to the address space of the process pointed to by the Process parameter. If the current thread was already attached to another process, the ApcState parameter receives the current APC state before KeStackAttachProcess attaches to the new process.
Every call to KeStackAttachProcess must be matched by a subsequent call to KeUnstackDetachProcess.
Note Attaching a thread to a different process can prevent asynchronous I/O operations from completing and can potentially cause deadlocks. In general, the lines of code between the call to KeStackAttachProcess and the call to KeUnstackDetachProcess should be very simple and should not call complex routines or send IRPs to other drivers.
For more information about using system threads and managing synchronization within a nonarbitrary thread context, see Windows Kernel-Mode Process and Thread Manager.