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

要件

要件 値
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib