estrutura WDF_INTERRUPT_INFO (wudfinterrupt.h)

Artigo
08/08/2023

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com 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 DIRQL no qual o dispositivo interrompe.

Mode

Um enumerador de tipo KINTERRUPT_MODE que indica se a interrupção é disparada em nível ou disparada por borda. O tipo de enumeração KINTERRUPT_MODE é definido em Wudfwdm.h.

Polarity

Um enumerador com 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 de 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 Wudfwdm.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 IWDFInterrupt::GetInfo . Para inicializar uma estrutura de WDF_INTERRUPT_INFO , o driver deve chamar WDF_INTERRUPT_INFO_INIT antes de chamar IWDFInterrupt::GetInfo.