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 を呼び出す必要があります。 たとえば、ドライバーは IQueueCallbackRead::OnRead から IWDFInterrupt::TryToAcquireInterruptLock を呼び出します。

これにより、次のシナリオで説明するように、デッドロックの可能性を回避できます。

  1. デバイスが中断されたかどうかを判断するために、UMDF は割り込みロックを保持した状態で、ISR 内からバスに I/O を送信します。
  2. バス ドライバーは、上記の要求を受信したのと同じスレッドで 2 番目の要求を完了します。
  3. 2 番目の要求の完了ルーチンは、UMDF ドライバーに要求を送信します。
  4. UMDF ドライバーの I/O ディスパッチ ルーチンは 、IWDFInterrupt::AcquireInterruptLock を呼び出します。これにより、割り込みロックの取得を試みるデッドロックが発生します。
ドライバーは、ロックを再帰的に取得しようとしないでください。 デバッガーに接続されている場合、フレームワークはこのシナリオでブレークポイントを導入します。

手動割り込みロックの詳細については、「 割り込みコードの同期」を参照してください。

UMDF ドライバーでの割り込みの処理の詳細については、「 ハードウェアへのアクセス」および「割り込みの処理」を参照してください。

要件

要件 値
サポート終了 UMDF 2.0 以降では使用できません。
対象プラットフォーム デスクトップ
最小 UMDF バージョン 1.11
Header wudfddi.h
[DLL] WUDFx.dll

こちらもご覧ください

IWDFInterrupt

IWDFInterrupt::ReleaseInterruptLock

WdfInterruptAcquireLock