Partager via


union NVME_CDW11_FEATURE_INTERRUPT_COALESCING (nvme.h)

Contient des paramètres pour la fonctionnalité de fusion d’interruption 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;

Members

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 de base de 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 qu’un contrôleur peut retarder une interruption en raison d’une fusion d’interruption. Une valeur correspondant 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 l’heure d’agrégation (TIME) ou les conditions de seuil d’agrégation (THR) sont remplies. Si les champs TIME ou THR sont effacés 0h, l’interruption de fusion est implicitement désactivée.

La fonctionnalité de fusion des interruptions est valide lorsque le contrôleur est configuré pour les interruptions de code confidentiel, MSI, MSI multiple 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 re-émet cette fonctionnalité après avoir modifié les modes d’interruption.

Le contrôleur peut retarder une interruption s’il détecte que les interruptions sont déjà traitées pour ce vecteur. Plus précisément, si le registre Head Doorbell de la 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 des interruptions retardées indéfiniment dans certaines charges de travail où le délai d’agrégation ou le seuil d’agrégation ne sont pas zéro.

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

Spécifications

Requirement Valeur
Client minimum requis Windows 10
Header nvme.h

Voir aussi