Partilhar via


NVME_CDW10_CREATE_IO_QUEUE união (nvme.h)

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 do Administrador 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;

Members

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 cabeçalho da fila de conclusão usado para o comando Fila de Conclusão ou à Porta traseira da fila de envio usada 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 fila de envio a ser criada. O Tamanho da Fila é indicado em um campo baseado em 16 bits 0 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 suportado pelo controlador que é relatado no campo MQES (entradas de fila máximas com suporte) da estrutura NVME_CONTROLLER_CAPABILITIES .

O tamanho máximo para o Envio de Administrador e a Fila de Conclusão de Administrador é 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

Requirements

Requirement Value
Cliente mínimo suportado Windows 10
Header nvme.h

Consulte também