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
                    );

要件

こちらもご覧ください

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT