WdfInterruptGetInfo 関数 (wdfinterrupt.h)
[KMDF と UMDF に適用]
WdfInterruptGetInfo メソッドは、指定された割り込みに関する情報を取得します。
構文
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
パラメーター
[in] Interrupt
割り込みオブジェクトへのハンドル。
[in, out] Info
WDF_INTERRUPT_INFO_INITを呼び出すことによって 初期化された呼 び出し元によって割り当てられた WDF_INTERRUPT_INFO構造体へのポインター。
戻り値
なし
解説
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
WdfInterruptGetInfo メソッドは、フレームワークがドライバーの EvtDevicePrepareHardware コールバック関数を呼び出した後、およびフレームワークがドライバーの EvtDeviceReleaseHardware コールバック関数を呼び出す前に、ドライバーが割り込み情報を呼び出す場合にのみ、割り込み情報を取得できます。
WdfInterruptGetInfo が返された後、ドライバーは、WDF_INTERRUPT_INFO構造体の Irql メンバーを調べることによって、パッシブ レベルの割り込みオブジェクトを識別できます。 パッシブ レベルの割り込みオブジェクトの場合、この値はPASSIVE_LEVEL。
ドライバーのコールバック関数が呼び出される順序については、「 PnP と Power Management のシナリオ」を参照してください。
フレームワーク ベースのドライバーでの割り込みの処理の詳細については、「 ハードウェア割り込みの処理」を参照してください。
例
次のコード例では、 WDF_INTERRUPT_INFO 構造体を初期化し、 WdfInterruptGetInfo を呼び出します。
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfinterrupt.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf) |