union NVME_CDW11_FEATURE_INTERRUPT_COALESCING (nvme.h)

  • Article

Contient des paramètres pour la fonctionnalité de fusion des interruptions qui configure les paramètres de fusion des interruptions.

Les valeurs de cette structure sont utilisées dans le champ InterruptCoalescing de la structure NVME_CDW11_FEATURES .

Syntaxe

typedef union {
  struct {
    ULONG THR : 8;
    ULONG TIME : 8;
    ULONG Reserved0 : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW11_FEATURE_INTERRUPT_COALESCING, *PNVME_CDW11_FEATURE_INTERRUPT_COALESCING;

Membres

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.THR

Indique le nombre minimal recommandé d’entrées de file d’attente d’achèvement à agréger par vecteur d’interruption avant de signaler une interruption à l’hôte. Il s’agit d’une valeur basée sur 0. La valeur de réinitialisation de ce paramètre est 0h.

DUMMYSTRUCTNAME.TIME

Indique la durée maximale recommandée par incréments de 100 microsecondes pendant laquelle un contrôleur peut retarder une interruption en raison de la fusion des interruptions. La valeur correspond 0h à aucun délai. Le contrôleur peut appliquer cette fois par vecteur d’interruption ou sur tous les vecteurs d’interruption. La valeur de réinitialisation de ce paramètre est 0h.

DUMMYSTRUCTNAME.Reserved0

AsUlong

Remarques

Le contrôleur signale une interruption lorsque les conditions de temps d’agrégation (TIME) ou de seuil d’agrégation (THR) sont remplies. Si les champs TIME ou THR sont effacés en 0h, la fusion des interruptions est implicitement désactivée.

La fonctionnalité de fusion des interruptions est valide lorsque le contrôleur est configuré pour les interruptions basées sur des broches, MSI, MSI multiples ou MSI-X. Il n’est pas nécessaire que le contrôleur conserve ces paramètres si les modes d’interruption sont modifiés. Il est recommandé que l’hôte ré-émette cette fonctionnalité après avoir modifié les modes d’interruption.

Le contrôleur peut retarder une interruption s’il détecte que des interruptions sont déjà traitées pour ce vecteur. Plus précisément, si le registre De porte de la tête de file d’attente d’achèvement est mis à jour associé à un vecteur d’interruption particulier, le contrôleur a une indication positive que les entrées de file d’attente d’achèvement sont déjà traitées. Dans ce cas, l’heure d’agrégation et/ou le seuil d’agrégation peuvent être réinitialisés/redémarrés lors de l’écriture du registre associé. Cela peut entraîner un retard indéfini des interruptions dans certaines charges de travail où le temps d’agrégation ou le seuil d’agrégation n’est pas égal à zéro.

La fonctionnalité de fusion des interruptions s’applique uniquement aux files d’attente de soumission d’E/S et d’achèvement d’E/S. Les interruptions pour les commandes qui se terminent par erreur ne doivent pas être coalescées.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
En-tête nvme.h

Voir aussi