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 と電源管理のシナリオ を参照してください。

フレームワーク ベースのドライバーでの割り込みの処理の詳細については、「ハードウェア割り込みの処理」を参照してください。

例示

次のコード例では、WDF_INTERRUPT_INFO 構造体を初期化し、WdfInterruptGetInfo 呼び出します。

WDF_INTERRUPT_INFO  Info;

WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
                    Interrupt,
                    &Info
                    );

必要条件

要件	価値
ターゲット プラットフォーム の	普遍
最小 KMDF バージョン	1.0
UMDF の最小バージョン を する	2.0
ヘッダー	wdfinterrupt.h (Wdf.h を含む)
図書館	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則 を する	DriverCreate(kmdf)

こちらもご覧ください

EvtDevicePrepareHardware の

EvtDeviceReleaseHardware の

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT