IWDFInterrupt::AcquireInterruptLock メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
AcquireInterruptLock メソッドは、割り込みオブジェクトのロックを保持しながら実行するコード シーケンスを開始します。
構文
void AcquireInterruptLock();
戻り値
何一つ
備考
ドライバーが AcquireInterruptLock 呼び出すと、システムはフレームワークの割り込みロックを取得します。
ドライバーが ReleaseInterruptLock 呼び出すと、システムは割り込みロックを解放します。
ドライバーが割り込まれたり割り込みサービスを無効にしたりせずに数行のコードを実行する必要がある場合は、AcquireInterruptLock を使用して ReleaseInterruptLock を できます。
ドライバーは、フレームワークがドライバーの OnInterruptEnable コールバック関数を呼び出す前、またはフレームワークがドライバーの OnInterruptDisable コールバック関数を呼び出した後に、AcquireInterruptLock を呼び出すことはできません。
ドライバーが AcquireInterruptLock 呼び出した後、ReleaseInterruptLock を呼び出す前に、同じ割り込みオブジェクトに対してメソッド再度呼び出してはなりません。
I/O キュー コールバック メソッドなどの任意のスレッドで実行する場合、ドライバーは IWDFInterrupt::AcquireInterruptLock ではなく、IWDFInterrupt::TryToAcquireInterruptLock 呼び出す必要があります。 たとえば、ドライバーは IWDFInterrupt::TryToAcquireInterruptLock IQueueCallbackRead::OnReadから 呼び出します。
これにより、次のシナリオで説明するように、デッドロックが発生する可能性が回避されます。
- デバイスが中断されたかどうかを判断するために、UMDF は割り込みロックを保持した状態で、ISR 内からバスに I/O を送信します。
- バス ドライバーは、上記の要求を受信したのと同じスレッドで 2 番目の要求を完了します。
- 2 番目の要求の完了ルーチンは、UMDF ドライバーに要求を送信します。
- UMDF ドライバーの I/O ディスパッチ ルーチンは、IWDFInterrupt::AcquireInterruptLock 呼び出します。これにより、割り込みロックの取得を試みるデッドロックが発生します。
手動割り込みロックの詳細については、「割り込みコードの同期」を参照してください。
UMDF ドライバーでの割り込みの処理の詳細については、「ハードウェアへのアクセスと割り込みの処理を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| ターゲット プラットフォーム の | デスクトップ |
| UMDF の最小バージョン を する | 1.11 |
| ヘッダー | wudfddi.h |
| DLL | WUDFx.dll |