unión NVME_COMPLETION_QUEUE_HEAD_DOORBELL (nvme.h)

Define el registro de timbre de puerta que actualiza el puntero de entrada principal para la cola de finalización y.

El valor de y es equivalente al identificador de cola, el valor de identificador de 16 bits que se asigna a la cola cuando se crea, este valor indica entradas de cola de finalización procesadas por software host.

El desplazamiento de la cola de finalización y el timbre principal (CQyHDBL) es: (1000h + ((2y + 1) * (4 << CAP.DSTRD)))

Donde CAP.DSTRD es el valor del campo DSTRD en NVME_CONTROLLER_CAPABILITIES.

Sintaxis

typedef union {
  struct {
    ULONG CQH : 16;
    ULONG Reserved0 : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_COMPLETION_QUEUE_HEAD_DOORBELL, *PNVME_COMPLETION_QUEUE_HEAD_DOORBELL;

Miembros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.CQH

Campo de lectura y escritura que indica el nuevo valor del puntero de entrada Encabezado de cola de finalización.

Este valor sobrescribirá cualquier valor de Encabezado de cola de finalización (CQH) proporcionado anteriormente. La diferencia entre la última escritura de CQH y la escritura del puntero de entrada CQH actual indica el número de entradas que ahora están disponibles para volver a usar el controlador en la cola de finalización.

DUMMYSTRUCTNAME.Reserved0

Campo reservado de solo lectura.

AsUlong

Comentarios

El host no debe leer los registros de timbre. Si se lee un registro de timbre, el valor devuelto es específico del proveedor. La escritura en un timbre principal de cola de finalización no existente tiene resultados indefinidos.

El software host debe seguir procesando las entradas de cola de finalización dentro de las colas de finalización, independientemente de si hay entradas disponibles en cualquier cola de envío.

Requisitos