WDF_INTERRUPT_INFO-Struktur (wdfinterrupt.h)

Artikel
02/29/2024

[Gilt für KMDF und UMDF]

Die WDF_INTERRUPT_INFO-Struktur enthält Informationen zur Interruptressource eines Geräts.

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Reserved1

Dieses Element ist für die zukünftige Verwendung reserviert.

TargetProcessorSet

Ein KAFFINITY-typisierter Wert, der die Prozessoraffinität des Interrupts angibt.

Reserved2

Dieses Element ist für die zukünftige Verwendung reserviert.

MessageNumber

Wenn das MessageSignaled-ElementTRUE ist, ist dies die Nachrichtennummer des Interrupts.

Vector

Der Interruptvektor.

Irql

Die IRQL, bei der das Gerät unterbricht.

Mode

Ein KINTERRUPT_MODE typisiertes Enumerator, der angibt, ob der Interrupt level-triggered oder edge-triggered ist.

Polarity

Ein WDF_INTERRUPT_POLARITY typisierter Enumerator, der die Polarität des Interruptsignals identifiziert.

MessageSignaled

Ein boolescher Wert, der bei TRUE angibt, dass der Interrupt nachrichtenseitig signalisiert wird. Wenn FALSE, wird der Interrupt nicht als Meldung signalisiert.

ShareDisposition

Ein CM_SHARE_DISPOSITION typisiertes Enumerator, der angibt, ob der Interrupt freigegeben wird. Der Wert ist CmResourceShared , wenn der Interrupt freigegeben wird, oder CmResourceShareDeviceExclusive , wenn der Interrupt nicht freigegeben wird. Der CM_SHARE_DISPOSITION Enumerationstyp ist in Wdm.h definiert.

Group

Ein Wert, der die Prozessorgruppe angibt, auf die das TargetProcessorSet-Mitglied angewendet wird. Dieser Wert ist 0, wenn der Computer nur über eine Prozessorgruppe verfügt oder wenn das Betriebssystem keine Prozessorgruppen unterstützt. Das Gruppenmitglied ist in Version 1.9 und höher von KMDF verfügbar.

Hinweise

Die WDF_INTERRUPT_INFO-Struktur wird als Eingabe für die WdfInterruptGetInfo-Methode verwendet. Um eine WDF_INTERRUPT_INFO-Struktur zu initialisieren, sollte Ihr Treiber WDF_INTERRUPT_INFO_INIT aufrufen, bevor WdfInterruptGetInfo aufgerufen wird.