KsQueueWorkItem 関数 (ks.h)

KsQueueWorkItem 関数は、指定された作業項目を、KsRegisterWorker 関数によって作成されたワーカーと共にキューに入れます。

構文

KSDDKAPI NTSTATUS KsQueueWorkItem(
  [in] PKSWORKER        Worker,
  [in] PWORK_QUEUE_ITEM WorkItem
);

[in] Worker

以前に割り当てられたワーカーを指定します。

[in] WorkItem

キューに初期化された作業項目を指定します。この作業項目は、ワーカーがキューにある限り、ワーカーにのみ関連付けられます。作業項目は、IoAllocateWorkItemによって初期化されている必要があります。

KsQueueWorkItem 関数は、作業項目がキューに入れられていた場合、または失敗した場合は、現在使用可能なスレッドがない場合に新しいワーカーを作成しようとしたときにエラーを返すSTATUS_SUCCESSを返します。

ワーカーは 1 か所のキューにのみ存在できるため、後続のワーカーキューは、作業項目の実行が開始されるまで待機する必要があります。この関数は、DISPATCH_LEVELで呼び出される場合があります。