estrutura WDF_INTERRUPT_INFO (wdfinterrupt.h)

Artigo
02/27/2024

[Aplica-se a KMDF e UMDF]

A estrutura WDF_INTERRUPT_INFO contém informações sobre o recurso de interrupção de um dispositivo.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Reserved1

Este membro é reservado para uso futuro.

TargetProcessorSet

Um valor do tipo KAFFINITY que especifica a afinidade do processador da interrupção.

Reserved2

Este membro é reservado para uso futuro.

MessageNumber

Se o membro MessageSignaled for TRUE, esse será o número da mensagem da interrupção.

Vector

O vetor de interrupção.

Irql

O IRQL no qual o dispositivo interrompe.

Mode

Um enumerador do tipo KINTERRUPT_MODE que indica se a interrupção é disparada por nível ou disparada por borda.

Polarity

Um enumerador do tipo WDF_INTERRUPT_POLARITY que identifica a polaridade do sinal de interrupção.

MessageSignaled

Um valor booliano que, se TRUE, indica que a interrupção é sinalizada por mensagem. Se FALSE, a interrupção não será sinalizada por mensagem.

ShareDisposition

Um enumerador do tipo CM_SHARE_DISPOSITION que indica se a interrupção está sendo compartilhada. O valor será CmResourceShareShared se a interrupção estiver sendo compartilhada ou CmResourceShareDeviceExclusive se a interrupção não estiver sendo compartilhada. O tipo de enumeração CM_SHARE_DISPOSITION é definido em Wdm.h.

Group

Um valor que identifica o grupo de processadores ao qual o membro TargetProcessorSet se aplica. Esse valor será zero se o computador tiver apenas um grupo de processadores ou se o sistema operacional não oferecer suporte a grupos de processadores. O membro group está disponível na versão 1.9 e versões posteriores do KMDF.

Comentários

A estrutura WDF_INTERRUPT_INFO é usada como entrada para o método WdfInterruptGetInfo . Para inicializar uma estrutura de WDF_INTERRUPT_INFO , o driver deve chamar WDF_INTERRUPT_INFO_INIT antes de chamar WdfInterruptGetInfo.