NVME_COMPLETION_QUEUE_HEAD_DOORBELL union （nvme.h）

定义更新完成队列 y 的头条目指针的门铃寄存器。

y 的值等效于队列标识符，即创建队列时分配给队列的 16 位 ID 值，此值指示主机软件已处理的完成队列条目。

完成队列 y 头门铃（CQyHDBL）的偏移量为： (1000h + ((2y + 1) * (4 << CAP.DSTRD)))

其中CAP.DSTRD，NVME_CONTROLLER_CAPABILITIES中 DSTRD 字段的值。

Syntax

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

Members

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.CQH

一个读/写字段，指示完成队列头条目指针的新值。

此值将覆盖以前提供的任何完成队列头（CQH）值。 最后 一个 CQH 写入与当前 CQH 条目指针写入之间的差异指示现在可供完成队列中的控制器重复使用的条目数。

DUMMYSTRUCTNAME.Reserved0

只读保留字段。

AsUlong

注解

主机不应读取门铃寄存器。 如果读取门铃寄存器，则返回的值特定于供应商。 写入到不存在的完成队列头门铃具有未定义的结果。

主机软件应继续处理完成队列中的完成队列条目，而不考虑是否有任何提交队列中可用的条目。

要求