WDF_INTERRUPT_INFO 構造体 (wudfinterrupt.h)

[アーティクル]
03/05/2024

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

WDF_INTERRUPT_INFO構造体には、デバイスの割り込みリソースに関する情報が含まれています。

構文

typedef struct _WDF_INTERRUPT_INFO {
  ULONG                  Size;
  ULONG64                Reserved1;
  KAFFINITY              TargetProcessorSet;
  ULONG                  Reserved2;
  ULONG                  MessageNumber;
  ULONG                  Vector;
  KIRQL                  Irql;
  KINTERRUPT_MODE        Mode;
  WDF_INTERRUPT_POLARITY Polarity;
  BOOLEAN                MessageSignaled;
  UCHAR                  ShareDisposition;
  USHORT                 Group;
} WDF_INTERRUPT_INFO, *PWDF_INTERRUPT_INFO;

メンバー

Size

この構造体のサイズ (バイト単位)。

Reserved1

このメンバーは将来使用するために予約されています。

TargetProcessorSet

割り込みのプロセッサアフィニティを指定する KAFFINITY 型の値。

Reserved2

このメンバーは将来使用するために予約されています。

MessageNumber

MessageSignaled メンバーが TRUE の場合、これは割り込みのメッセージ番号です。

Vector

割り込みベクトル。

Irql

デバイスが割り込む DIRQL。

Mode

割り込みがレベルトリガーかエッジトリガーかを示す、 KINTERRUPT_MODE型の列挙子。 KINTERRUPT_MODE列挙型は Wudfwdm.h で定義されています。

Polarity

割り込みシグナルの極性を識別するWDF_INTERRUPT_POLARITY型の列挙子。

MessageSignaled

TRUE の場合、割り込みがメッセージシグナルであることを示すブール値。 FALSE の場合、割り込みはメッセージ通知されません。

ShareDisposition

割り込みが共有されているかどうかを示すCM_SHARE_DISPOSITION型指定された列挙子。割り込みが共有されている場合は CmResourceShareShared 、割り込みが共有されていない場合は CmResourceShareDeviceExclusive の値です。 CM_SHARE_DISPOSITION列挙型は Wudfwdm.h で定義されています。

Group

TargetProcessorSet メンバーが適用されるプロセッサグループを識別する値。コンピューターにプロセッサグループが 1 つしかない場合、またはオペレーティングシステムがプロセッサグループをサポートしていない場合、この値は 0 です。 グループ メンバーは、バージョン 1.9 以降のバージョンの KMDF で使用できます。

注釈

WDF_INTERRUPT_INFO構造体は、IWDFInterrupt::GetInfo メソッドへの入力として使用されます。 WDF_INTERRUPT_INFO構造体を初期化するには、ドライバーは IWDFInterrupt::GetInfo を呼び出す前に WDF_INTERRUPT_INFO_INIT を呼び出す必要があります。