次の方法で共有


WUDF_INTERRUPT_ISR コールバック関数 (wudfinterrupt.h)

警告

UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。

ドライバーの OnInterruptIsr イベント コールバック関数は、ハードウェア割り込みを処理します。

構文

typedef
BOOLEAN
_Function_class_(WUDF_INTERRUPT_ISR)
WUDF_INTERRUPT_ISR(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    ULONG MessageID,
    _In_
    ULONG Reserved
    );

typedef WUDF_INTERRUPT_ISR *PFN_WUDF_INTERRUPT_ISR;

パラメーター

[in] Interrupt

IWDFInterrupt インターフェイスへのポインター。

[in] MessageID

デバイスがメッセージ信号割り込み (MSI) を使用している場合、このパラメーターはデバイスのハードウェア割り込みメッセージを識別するメッセージ番号です。 それ以外の場合、この値は 0 です。

[in] Reserved

システム用に予約されています。

戻り値

何一つ

備考

ドライバーが割り込みの所有権を確認し、停止し、そのデバイスの割り込みを確認した場合は TRUE を返します。 それ以外の場合は FALSE を返します。

OnInterruptIsr コールバック関数を登録するには、ドライバーは、IWDFDevice3::CreateInterruptを呼び出す前に、コールバック関数のアドレスを WUDF_INTERRUPT_CONFIG 構造体に配置する必要があります。

OnInterruptIsr コールバック関数は、UMDF ドライバーの割り込みサービス ルーチン (ISR) です。これは、ハードウェア割り込みが発生したときにPASSIVE_LEVELに呼び出されます。

エッジ によってトリガーされる割り込みまたはメッセージシグナル割り込み (MSI) の場合、フレームワークはオペレーティング システムの割り込みディスパッチ コンテキストの外部 OnInterruptIsr を呼び出します。 これは、UMDF では共有されていないエッジ トリガー割り込みまたは MSI 割り込みのみが許可され、ドライバーはこのコンテキスト内でそのハードウェアと対話する必要がないためです。

レベルによってトリガーされる割り込みの場合、フレームワークはオペレーティング システム 割り込みディスパッチのコンテキストで onInterruptIsr を呼び出します。 その結果、ドライバーからの応答を待機しているカーネル モードでオペレーティング システムの割り込みディスパッチ スレッドがブロックされます。

通常、OnInterruptIsr は、失われる可能性がある揮発性の情報を保存し、ハードウェア割り込みをクリアします。 レベルによってトリガーされる割り込みの場合、ドライバーは停止し、デバイスの割り込みを確認し、割り込みを所有している場合は TRUE を返す必要があります。 ドライバーは、OnInterruptWorkItem コールバックでそれ以上の処理を行う必要があります。 作業項目をキューに格納するために、ドライバーは IWDFInterrupt::QueueWorkItemForIsr メソッドを呼び出します。

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

関数型は、次のように、Wudfinterrupt.hで宣言されています。

typedef
BOOLEAN
WUDF_INTERRUPT_ISR(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    ULONG MessageID,
    _In_
    ULONG Reserved
    );

typedef WUDF_INTERRUPT_ISR *PFN_WUDF_INTERRUPT_ISR;

MyInterruptIsr という名前の OnInterruptIsr コールバック関数定義するには、まず、SDV およびその他の検証ツールで必要な関数宣言を次のように指定する必要があります。

WUDF_INTERRUPT_NOTIFY  MyInterruptIsr;

次に、次のようにコールバック関数を実装します。

BOOLEAN
  MyInterruptIsr (
    IN IWDFInterrupt*  Interrupt,
    IN ULONG  MessageID,
    IN ULONG Reserved
    )
  {…}

必要条件

要件 価値
サポート終了 UMDF 2.0 以降では使用できません。
ターゲット プラットフォーム デスクトップ
UMDF の最小バージョン する 1.11
ヘッダー wudfinterrupt.h

関連項目