Compartilhar via

união NVME_CDW10_CREATE_IO_QUEUE (nvme.h)

  • Artigo

Contém parâmetros usados nos comandos Criar Fila de Conclusão de E/S e Criar Fila de Envio de E/S. O comando Criar Fila de Conclusão de E/S é usado para criar todas as Filas de Conclusão de E/S com exceção da Fila de Conclusão Administração e o comando Criar Fila de Envio de E/S é usado para criar Filas de Envio de E/S.

A estrutura NVME_CDW10_CREATE_IO_QUEUE é usada no campo CDW10 dos parâmetros CREATEIOCQ e CREATEIOSQ da estrutura Command .

Sintaxe

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

Membros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.QID

O campo QID (Identificador de Fila) indica o identificador a ser atribuído à Fila de Conclusão ou à Fila de Envio a ser criada.

Esse identificador corresponde ao Doorbell de Cabeçalho da Fila de Conclusão usado para o comando Fila de Conclusão ou o Doorbell da Fila de Envio usado para o comando Fila de Envio.

Esse valor de ID de 16 bits não deve exceder o valor relatado no recurso NVME_FEATURE_NUMBER_OF_QUEUES para Filas de Conclusão de E/S ou Filas de Envio de E/S. Se o valor especificado for 0h, exceder o Número de Filas relatadas ou corresponder a um identificador já em uso, o controlador deverá retornar um erro de NVME_STATUS_INVALID_QUEUE_IDENTIFIER.

DUMMYSTRUCTNAME.QSIZE

O campo Tamanho da Fila (QSIZE) indica o tamanho da Fila de Conclusão ou da Fila de Envio a ser criada. O Tamanho da Fila é indicado em um campo baseado em 0 de 16 bits que especifica o número de entradas na fila.

O tamanho mínimo de uma fila é de duas entradas. O tamanho máximo para uma Fila de Envio de E/S ou uma Fila de Conclusão de E/S é de 64 mil entradas, limitadas pelo tamanho máximo da fila compatível com o controlador relatado no campo MQES (Entradas de Fila Máximas Com Suporte) da estrutura NVME_CONTROLLER_CAPABILITIES .

O tamanho máximo para o Envio de Administração e Administração Fila de Conclusão é definido como entradas de 4K. Uma entrada em cada fila não está disponível para uso devido à definição do ponteiro de entrada Head e Tail.

Se o tamanho for 0h ou maior do que o controlador dá suporte, o controlador deverá retornar um erro de Tamanho de Fila Inválido.

AsUlong

Requisitos

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

Confira também