WdfInterruptQueueWorkItemForIsr 関数 (wdfinterrupt.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfInterruptQueueWorkItemForIsr メソッドは、フレームワーク割り込みオブジェクトの EvtInterruptWorkItem コールバック関数をキューに入れ、実行します。

構文

BOOLEAN WdfInterruptQueueWorkItemForIsr(
  [in] WDFINTERRUPT Interrupt
);

パラメーター

[in] Interrupt

フレームワーク割り込みオブジェクトへのハンドル。

戻り値

ドライバーの ISR が IRQL = PASSIVE_LEVELで実行されている場合、割り込みオブジェクトの EvtInterruptWorkItem コールバック関数を正常にキューに入れた場合、WdfInterruptQueueWorkItemForIsr は TRUE を返します。 コールバック関数が以前にキューに登録されていて、実行されていない場合、メソッドは FALSE を 返します。

ドライバーの ISR が IRQL = DIRQL で実行されている場合、フレームワークは最初に内部 DPC をキューに入れ、その DPC の作業項目をキューに入れます。 この場合、フレームワークが内部 DPC を正常にキューに入れた場合、 WdfInterruptQueueWorkItemForIsr はTRUE を 返します。 内部 DPC が以前にキューに入っていた場合、メソッドは FALSE を 返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

ドライバーは通常、EvtInterruptIsr コールバック関数内から WdfInterruptQueueWorkItemForIsr を呼び出します。

割り込みオブジェクトの EvtInterruptWorkItem コールバック関数は、実行前に 1 回だけキューに入れられます。 したがって、 WdfInterruptQueueWorkItemForIsr の呼び出しが成功した場合、後続の呼び出しでは追加のコールバックはキューに入れられません。

フレームワーク ベースのドライバーでの割り込みの処理の詳細については、「 ハードウェア割り込みの処理」を参照してください。

ドライバーが EvtInterruptWorkItem コールバック関数を指定しない割り込みオブジェクトを使用して WdfInterruptQueueWorkItemForIsr を呼び出すと、バグ チェックが発生します。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.11
最小 UMDF バージョン 2.0
Header wdfinterrupt.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DIRQL
DDI コンプライアンス規則 DriverCreate(kmdf)

こちらもご覧ください

EvtInterruptDpc

EvtInterruptIsr

WdfInterruptCreate

WdfInterruptQueueDpcForIsr