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で呼び出される場合があります。