KsRegisterWorker 関数 (ks.h)

KsRegisterWorker 関数は、スレッドの使用のために登録しているクライアントを処理します。 現在使用可能な空きスレッドがない場合、関数は指定された優先度の新しいスレッドを作成できます。 これは、スレッドの使用が完了したときに、対応する KsUnregisterWorker と一致する必要があります。 関数は、PASSIVE_LEVELでのみ呼び出すことができます。

typedef PVOID PKSWORKER;

ワーカー ルーチンは、一度にキューに登録された作業項目ごとに作成される不透明な PKSWORKER オブジェクトに対して機能します。

構文

KSDDKAPI NTSTATUS KsRegisterWorker(
  [in]  WORK_QUEUE_TYPE WorkQueueType,
  [out] PKSWORKER       *Worker
);

パラメーター

[in] WorkQueueType

作成するスレッドの優先度を指定します。 通常、これは CriticalWorkQueue、 DelayedWorkQueue、 HyperCriticalWorkQueue のいずれかです。

[out] Worker

作業項目をスケジュールするときに使用する必要がある不透明なコンテキストを配置する場所。 これにはキューの種類が含まれており、作業項目の完了を同期するために使用されます。

戻り値

KsRegisterWorker 関数は、ワーカーが初期化された場合、または失敗した場合にSTATUS_SUCCESSを返します。失敗した場合、関数はスレッドまたはパラメーター エラーを返します。

要件