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

ドライバーの OnInterruptEnable イベント コールバック関数は、指定されたハードウェア割り込みを有効にします。

構文

WUDF_INTERRUPT_ENABLE WudfInterruptEnable;

HRESULT WudfInterruptEnable(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFDevice *AssociatedDevice
)
{...}

パラメーター

[in] Interrupt

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

[in] AssociatedDevice

ドライバーが CreateInterrupt の呼び出しに使用した IWDFDevice インターフェイスポインター。

戻り値

操作が成功した場合、コールバック関数はS_OKを返す必要があります。 それ以外の場合、コールバックは Winerror.h で定義されているエラー コードのいずれかを返す必要があります。

備考

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

フレームワークは、デバイスが動作 (D0) 状態に入るたびに、ドライバーの OnInterruptEnable コールバック関数を呼び出します。 さらに、ドライバーは、IWDFInterrupt::Enable を呼び出すことによって、OnInterruptEnable コールバック関数呼び出すことができます。

OnInterruptEnable コールバック関数を呼び出す前に、フレームワークはユーザー モード割り込みロックを取得します。

OnInterruptEnable コールバック関数を呼び出した後、フレームワークはドライバーの OnD0EntryPostInterruptsEnabled イベント コールバック関数を呼び出します。

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

例

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

typedef
__drv_functionClass(WUDF_INTERRUPT_ENABLE)
HRESULT
WUDF_INTERRUPT_ENABLE(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFDevice* AssociatedDevice
    );

typedef WUDF_INTERRUPT_ENABLE *PFN_WUDF_INTERRUPT_ENABLE;

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

WUDF_INTERRUPT_ENABLE  MyInterruptEnable;

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

HRESULT
  MyInterruptEnable (
    IN IWDFInterrupt* pInterrupt,
    IN IWDFDevice*  pAssociatedDevice
    )
  {…}

必要条件

関連項目

• IWDFDevice::CreateInterrupt
• OnInterruptDisable
• WUDF_INTERRUPT_CONFIG