WdfInterruptQueueDpcForIsr 関数 (wdfinterrupt.h)
[KMDF と UMDF に適用]
WdfInterruptQueueDpcForIsr メソッドは、フレームワーク割り込みオブジェクトの EvtInterruptDpc コールバック関数をキューに入れ、実行します。
構文
BOOLEAN WdfInterruptQueueDpcForIsr(
[in] WDFINTERRUPT Interrupt
);
パラメーター
[in] Interrupt
フレームワーク割り込みオブジェクトへのハンドル。
戻り値
WdfInterruptQueueDpcForIsr は、割り込みオブジェクトの EvtInterruptDpc コールバック関数を正常にキューに入れた場合に TRUE を返します。 コールバック関数が以前にキューに登録されていて、実行されていない場合、メソッドは FALSE を 返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
ドライバーは通常、EvtInterruptIsr コールバック関数内から WdfInterruptQueueDpcForIsr を呼び出します。
割り込みオブジェクトの EvtInterruptDpc コールバック関数は、実行前に 1 回だけキューに入れられます。 したがって、WdfInterruptQueueDpcForIsr の呼び出しが成功した場合、フレームワークが EvtInterruptDpc コールバック関数をデキューするまで、後続の呼び出しは FALSE を返します。
EvtInterruptDpc コールバックは、エンキューしたプロセッサで実行されます。 EvtInterruptDpc コールバック関数が既にデキューまたは実行されている間にドライバーが WdfInterruptQueueDpcForIsr を呼び出して別の DPC をキューに入れる場合、最初のコールバックが完了する前に 2 番目の EvtInterruptDpc コールバックが実行される場合もあります。
フレームワーク ベースのドライバーでの割り込みの処理の詳細については、「 ハードウェア割り込みの処理」を参照してください。
KMDF 1.11 以降では、ドライバーはパッシブ レベルの ISR から WdfInterruptQueueDpcForIsr を呼び出すことができます。 ドライバーは作業項目または DPC を登録できますが、両方を登録することはできません。
例
次のコード例は、 EvtInterruptIsr コールバック関数が EvtInterruptDpc コールバック関数をキューに入れる方法を示しています。
BOOLEAN
MyEvtInterruptIsr(
IN WDFINTERRUPT Interrupt,
IN ULONG MessageID
)
{
BOOLEAN queueDpcSuccess;
//
// Save interrupt information for the
// EvtInterruptDpc function.
//
...
//
// Queue the EvtInterruptDpc function.
//
queueDpcSuccess = WdfInterruptQueueDpcForIsr(Interrupt);
...
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfinterrupt.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DIRQL |
| DDI コンプライアンス規則 | DriverCreate(kmdf) |