объединение NVME_CDW10_CREATE_IO_QUEUE (nvme.h)

  • Статья

Содержит параметры, используемые в командах Создать очередь завершения ввода-вывода и Создать очередь отправки ввода-вывода. Команда Создать очередь завершения ввода-вывода используется для создания всех очередей завершения ввода-вывода, за исключением очереди завершения Администратор, а команда Создать очередь отправки ввода-вывода используется для создания очередей отправки ввода-вывода.

Структура NVME_CDW10_CREATE_IO_QUEUE используется в поле CDW10 параметров CREATEIOCQ и CREATEIOSQ структуры Команд .

Синтаксис

typedef union {
  struct {
    ULONG QID : 16;
    ULONG QSIZE : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW10_CREATE_IO_QUEUE, *PNVME_CDW10_CREATE_IO_QUEUE;

Члены

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

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

Этот идентификатор соответствует либо заголовку doorbell очереди завершения, используемому для команды "Очередь завершения", либо команде "Очередь отправки" для команды "Очередь отправки".

Это 16-разрядное значение идентификатора не должно превышать значение, указанное в функции NVME_FEATURE_NUMBER_OF_QUEUES для очередей завершения ввода-вывода или очередей отправки ввода-вывода. Если указанное значение равно 0h, превышает указанное число очередей или соответствует уже используемому идентификатору, контроллер должен вернуть ошибку NVME_STATUS_INVALID_QUEUE_IDENTIFIER.

DUMMYSTRUCTNAME.QSIZE

В поле Размер очереди (QSIZE) указывается размер создаваемой очереди завершения или очереди отправки. Размер очереди указывается в 16-разрядном 0-разрядном поле, указывающем количество записей в очереди.

Минимальный размер очереди — две записи. Максимальный размер очереди отправки ввода-вывода или очереди завершения ввода-вывода составляет 64 КБ записей, что ограничивается максимальным размером очереди, поддерживаемым контроллером, который указывается в поле MQES структуры NVME_CONTROLLER_CAPABILITIES .

Максимальный размер очереди отправки и завершения Администратор Администратор определяется как записи размером 4 КБ. Одна запись в каждой очереди недоступна для использования из-за определения указателя входа Head и Tail.

Если размер или 0h больше, чем поддерживает контроллер, контроллер должен вернуть ошибку Недопустимый размер очереди.

AsUlong

Требования

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

См. также раздел