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

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

ドライバーの OnInterruptWorkItem イベント コールバック関数は、ドライバーの OnInterruptIsr コールバック関数が格納した割り込み情報を処理します。

構文

WUDF_INTERRUPT_WORKITEM WudfInterruptWorkitem;

void WudfInterruptWorkitem(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFObject *AssociatedObject
)
{...}

パラメーター

[in] Interrupt

作業項目に関連付けられている割り込みオブジェクト インターフェイスへのポインター。

[in] AssociatedObject

関連付けられたオブジェクトへのポインター。

戻り値

なし

解説

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

中断を停止して確認した後、ドライバーは OnInterruptIsr コールバックからすばやく戻り、追加の処理を OnInterruptWorkItem コールバックに延期する必要があります。

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

例

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

typedef
_Function_class_(WUDF_INTERRUPT_WORKITEM)
VOID
WUDF_INTERRUPT_WORKITEM(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFObject* AssociatedObject
    );

typedef WUDF_INTERRUPT_WORKITEM *PFN_WUDF_INTERRUPT_WORKITEM;

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

WUDF_INTERRUPT_WORKITEM  MyInterruptWorkItem;

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

VOID
  MyInterruptWorkItem (
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFObject* AssociatedObject
    )
  {…}

要件

こちらもご覧ください

IWDFDevice3::CreateInterrupt

WUDF_INTERRUPT_CONFIG