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 |