WDF_INTERRUPT_INFO structure (wudfinterrupt.h)

Article
02/27/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La structure WDF_INTERRUPT_INFO contient des informations sur la ressource d’interruption d’un appareil.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

Reserved1

Ce membre est réservé pour un usage ultérieur.

TargetProcessorSet

Valeur de type KAFFINITY qui spécifie l’affinité processeur de l’interruption.

Reserved2

Ce membre est réservé pour un usage ultérieur.

MessageNumber

Si le membre MessageSignaled a la valeur TRUE, il s’agit du numéro de message de l’interruption.

Vector

Vecteur d’interruption.

Irql

DIRQL à laquelle l’appareil s’interrompt.

Mode

Énumérateur de type KINTERRUPT_MODE qui indique si l’interruption est déclenchée au niveau ou déclenchée en périphérie. Le type d’énumération KINTERRUPT_MODE est défini dans Wudfwdm.h.

Polarity

Énumérateur WDF_INTERRUPT_POLARITY qui identifie la polarité du signal d’interruption.

MessageSignaled

Valeur booléenne qui, si elle est TRUE, indique que l’interruption est signalée par un message. Si la valeur est FALSE, l’interruption n’est pas signalée par un message.

ShareDisposition

Énumérateur CM_SHARE_DISPOSITION qui indique si l’interruption est partagée. La valeur est CmResourceShared si l’interruption est partagée ou CmResourceShareDeviceExclusive si l’interruption n’est pas partagée. Le type d’énumération CM_SHARE_DISPOSITION est défini dans Wudfwdm.h.

Group

Valeur qui identifie le groupe de processeurs auquel le membre TargetProcessorSet s’applique. Cette valeur est égale à zéro si l’ordinateur n’a qu’un seul groupe de processeurs ou si le système d’exploitation ne prend pas en charge les groupes de processeurs. Le membre groupe est disponible dans la version 1.9 et les versions ultérieures de KMDF.

Remarques

La structure WDF_INTERRUPT_INFO est utilisée comme entrée de la méthode IWDFInterrupt ::GetInfo . Pour initialiser une structure de WDF_INTERRUPT_INFO , votre pilote doit appeler WDF_INTERRUPT_INFO_INIT avant d’appeler IWDFInterrupt ::GetInfo.