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 である 必要があります。 Ntddk.h で定義されている NtCurrentProcess マクロを使用して、現在のプロセスを指定します。

[out, optional] ClientId

新しいスレッドのクライアント識別子を受け取る構造体を指します。この値は、ドライバーによって作成されたスレッドの 場合は NULL である 必要があります。

[in] StartRoutine

新しく作成されたシステムスレッドのエントリポイント。このパラメーターは、呼び出し元によって提供される StartContext パラメーター値である 1 つの引数を受け取る ThreadStart ルーチンへの関数ポインターです。

[in, optional] StartContext

実行の開始時にスレッドに渡される 1 つの引数を指定します。

戻り値

PsCreateSystemThread は、スレッドが作成された場合STATUS_SUCCESSを返します。

注釈

デバイス専用スレッドを作成するドライバーは、初期化時または I/O 要求がこのようなドライバーのディスパッチルーチンに入り始めるとき、このルーチンを呼び出します。たとえば、ドライバーは、非同期デバイス制御要求を受信したときに、このようなスレッドを作成する場合があります。

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で実行されます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm)