PsCreateSystemThread 函数 (wdm.h)

项目
03/08/2023

PsCreateSystemThread 例程创建一个系统线程，该线程在内核模式下执行，并返回线程的句柄。

语法

NTSTATUS PsCreateSystemThread(
  [out]           PHANDLE            ThreadHandle,
  [in]            ULONG              DesiredAccess,
  [in, optional]  POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional]  HANDLE             ProcessHandle,
  [out, optional] PCLIENT_ID         ClientId,
  [in]            PKSTART_ROUTINE    StartRoutine,
  [in, optional]  PVOID              StartContext
);

参数

[out] ThreadHandle

指向将接收句柄的变量。在句柄不再使用后，驱动程序必须使用 ZwClose 关闭该句柄。此句柄是 Windows Vista 和更高版本的 Windows 的内核句柄。在早期版本的 Windows 中，句柄可能不是内核句柄。

[in] DesiredAccess

指定 ACCESS_MASK 值，该值表示对所创建线程的请求访问类型。

[in, optional] ObjectAttributes

指向一个结构，该结构指定对象的属性。 OBJ_PERMANENT、OBJ_EXCLUSIVE和OBJ_OPENIF不是线程对象的有效属性。在 Windows XP 和更高版本的 Windows 上，如果调用方未在系统进程上下文中运行，则必须为 ObjectAttributes 设置 OBJ_KERNEL_HANDLE 属性。 Microsoft Windows 2000 和 Windows 98/Me 的驱动程序只能从系统进程上下文调用 PsCreateSystemThread 。对于 Windows Vista 和更高版本的 Windows，句柄将是内核句柄。

[in, optional] ProcessHandle

为要运行线程的地址空间的进程指定一个打开句柄。调用方线程必须具有对此进程的PROCESS_CREATE_THREAD访问权限。如果未提供此参数，将在初始系统进程中创建线程。对于驱动程序创建的线程，此值应为 NULL 。使用 Ntddk.h 中定义的 NtCurrentProcess 宏指定当前进程。

[out, optional] ClientId

指向接收新线程的客户端标识符的结构。对于驱动程序创建的线程，此值应为 NULL 。

[in] StartRoutine

新创建的系统线程的入口点。此参数是指向 ThreadStart 例程的函数指针，该例程接收单个参数，该参数是调用方提供的 StartContext 参数值。

[in, optional] StartContext

提供单个参数，该参数在线程开始执行时传递给线程。

返回值

如果创建了线程，PsCreateSystemThread 将返回STATUS_SUCCESS。

注解

创建设备专用线程的驱动程序在初始化或 I/O 请求开始传入此类驱动程序的 Dispatch 例程时调用此例程。例如，驱动程序在收到异步设备控制请求时可能会创建此类线程。

PsCreateSystemThread 创建内核模式线程，该线程在系统中开始单独的执行线程。此类系统线程没有 TEB 或用户模式上下文，并且仅在内核模式下运行。

如果输入 ProcessHandle 为 NULL，则创建的线程与系统进程相关联。此类线程将继续运行，直到系统关闭或线程通过调用 PsTerminateSystemThread 终止自身。

在非系统进程上下文中运行的驱动程序例程必须为 PsCreateSystemThread 的 ObjectAttributes 参数设置 OBJ_KERNEL_HANDLE 属性。这会将 PsCreateSystemThread 返回的句柄的使用限制为在内核模式下运行的进程。否则，线程句柄可由运行驱动程序的上下文的进程访问。驱动程序可以设置OBJ_KERNEL_HANDLE属性，如下所示。

InitializeObjectAttributes(&ObjectAttributes, NULL, OBJ_KERNEL_HANDLE, NULL, NULL);

有关 StartContext 参数的详细信息，请参阅 ThreadStart。

新创建的系统线程在关键区域内PASSIVE_LEVEL运行，并禁用了正常的内核 APC 。

要求

要求	值
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI (storport) ， IrqlPsPassive (wdm)