união NVME_CDW11_FEATURE_INTERRUPT_COALESCING (nvme.h)

  • Artigo

Contém parâmetros para o Recurso de União de Interrupção que define as configurações de união de interrupção.

Os valores dessa estrutura são usados no campo InterruptCoalescing da estrutura NVME_CDW11_FEATURES .

Sintaxe

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;

Membros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.THR

Indica o número mínimo recomendado de entradas de fila de conclusão a serem agregadas por vetor de interrupção antes de sinalizar uma interrupção para o host. Esse é um valor baseado em 0. O valor de redefinição dessa configuração é 0h.

DUMMYSTRUCTNAME.TIME

Indica o tempo máximo recomendado em incrementos de 100 microssegundos que um controlador pode atrasar uma interrupção devido à união de interrupção. Um valor de 0h corresponde a nenhum atraso. O controlador pode aplicar esse tempo por vetor de interrupção ou em todos os vetores de interrupção. O valor de redefinição dessa configuração é 0h.

DUMMYSTRUCTNAME.Reserved0

AsUlong

Comentários

O controlador sinaliza uma interrupção quando as condições TIME (Tempo de Agregação) ou THR (Limite de Agregação) são atendidas. Se os campos TIME ou THR forem limpos para 0h, a união de interrupção será desabilitada implicitamente.

O Recurso de União de Interrupção é válido quando o controlador é configurado para interrupções baseadas em pin, MSI, várias MSI ou MSI-X. Não há nenhum requisito para o controlador persistir essas configurações se os modos de interrupção forem alterados. É recomendável que o host emita novamente esse recurso depois de alterar os modos de interrupção.

O controlador poderá atrasar uma interrupção se detectar que as interrupções já estão sendo processadas para esse vetor. Especificamente, se o registro do Head Doorbell da Fila de Conclusão estiver sendo atualizado associado a um vetor de interrupção específico, o controlador terá uma indicação positiva de que as entradas da fila de conclusão já estão sendo processadas. Nesse caso, o tempo de agregação e/ou o limite de agregação podem ser redefinidos/reiniciados após a gravação do registro associado. Isso pode resultar em interrupções atrasadas indefinidamente em determinadas cargas de trabalho em que o tempo de agregação ou o limite de agregação são diferentes de zero.

O recurso de união de interrupção se aplica somente às filas de conclusão de E/S e envio de E/S. interrupções para comandos que são concluídos com erro não devem ser agrupadas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Cabeçalho nvme.h

Confira também