структура NVME_COMPLETION_ENTRY (nvme.h)

Указывает запись в очереди завершения размером 16 байт.

Синтаксис

typedef struct {
  ULONG DW0;
  ULONG DW1;
  union {
    struct {
      USHORT SQHD;
      USHORT SQID;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW2;
  union {
    struct {
      USHORT              CID;
      NVME_COMMAND_STATUS Status;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW3;
} NVME_COMPLETION_ENTRY, *PNVME_COMPLETION_ENTRY;

Члены

DW0

Содержимое Dword 0 содержит сведения, относящиеся к командам.

Если команда использует Dword 0, то определение этого Dword содержится в связанном определении команды. Если команда не использует Dword 0, это поле зарезервировано.

DW1

DW2

Объединение, содержащее сведения в Dword 2.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

Указывает текущий указатель головы очереди отправки для очереди отправки, указанной в поле SQID. Он используется для указания ведущему объекту записей очереди отправки, которые были использованы и могут быть повторно использованы для новых записей.

Примечание

Возвращаемое значение — это значение указателя головки очереди отправки при создании записи очереди завершения. К тому времени, когда программное обеспечение узла использует запись очереди завершения, контроллер может иметь указатель SQ Head, который превышает указанное значение.

DW2.DUMMYSTRUCTNAME.SQID

Указывает очередь отправки, в которую была выдана связанная команда. Поле SQID используется в сочетании с идентификатором команды (CID) главным программным обеспечением для уникального определения выполненной команды, если несколько очередей отправки совместно используют одну очередь завершения.

DW2.AsUlong

DW3

Объединение, содержащее сведения в Dword 3.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

Указывает идентификатор выполняемой команды.

Этот идентификатор назначается ведущим программным обеспечением при отправке команды в очередь отправки. Сочетание SQID идентификатора SQID и идентификатора команды однозначно идентифицирует выполняемую команду. Максимальное число одновременно невыполненных запросов составляет 64 КБ.

DW3.DUMMYSTRUCTNAME.Status

Структура NVME_COMMAND_STATUS , указывающая состояние выполняемой команды.

Значение 0h для этого поля указывает на успешное выполнение команды без неустранимых или неустранимых условий ошибок. Если не указано иное, если команда не завершается успешно по нескольким причинам, поставщик выбирает конкретный код состояния.

DW3.AsUlong

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Верхняя часть	nvme.h