psCreateSystemThread 函式 (wdm.h)

發行項
02/27/2024

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 。使用 NtCurrentProcess 宏，定義於 Ntddk.h 中，以指定目前的進程。

[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。

新建立的系統線程會在已停用一般核心 APC 的重要區域中PASSIVE_LEVEL執行。

規格需求

需求	值
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 IrqlPsPassive (wdm)