unión NVME_CDW11_FEATURE_INTERRUPT_COALESCING (nvme.h)

  • Artículo

Contiene parámetros para la característica de fusión de interrupciones que configura las opciones de fusión de interrupciones.

Los valores de esta estructura se usan en el campo InterruptCoalescing de la estructura NVME_CDW11_FEATURES .

Sintaxis

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;

Miembros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.THR

Indica el número mínimo recomendado de entradas de cola de finalización para agregar por vector de interrupción antes de señalar una interrupción al host. Se trata de un valor basado en 0. El valor de restablecimiento de esta configuración es 0h.

DUMMYSTRUCTNAME.TIME

Indica el tiempo máximo recomendado en incrementos de 100 microsegundos que un controlador puede retrasar una interrupción debido a la fusión de interrupciones. Un valor de 0h corresponde a ningún retraso. El controlador puede aplicar esta hora por vector de interrupción o en todos los vectores de interrupción. El valor de restablecimiento de esta configuración es 0h.

DUMMYSTRUCTNAME.Reserved0

AsUlong

Comentarios

El controlador señala una interrupción cuando se cumplen las condiciones tiempo de agregación (TIME) o umbral de agregación (THR). Si los campos TIME o THR se borran en 0h, la fusión de interrupciones se deshabilita implícitamente.

La característica de fusión de interrupciones es válida cuando el controlador está configurado para interrupciones basadas en patillas, MSI, múltiples MSI o MSI-X. No es necesario que el controlador conserve esta configuración si se cambian los modos de interrupción. Se recomienda que el host vuelva a emitir esta característica después de cambiar los modos de interrupción.

El controlador puede retrasar una interrupción si detecta que las interrupciones ya se están procesando para este vector. En concreto, si se actualiza el registro de timbre principal de cola de finalización que está asociado a un vector de interrupción determinado, el controlador tiene una indicación positiva de que las entradas de cola de finalización ya se están procesando. En este caso, la hora de agregación o el umbral de agregación se pueden restablecer o reiniciar tras la escritura de registro asociada. Esto puede provocar interrupciones que se retrasan indefinidamente en determinadas cargas de trabajo en las que el tiempo de agregación o el umbral de agregación no son cero.

La característica de fusión de interrupciones solo se aplica a las colas de envío de E/S y finalización de E/S. Las interrupciones de los comandos que se completan en error no se deben fusionar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Encabezado nvme.h

Consulte también