Partager via


union NVME_CDW11_CREATE_IO_SQ (nvme.h)

Contient les paramètres de la commande Créer une file d’attente de soumission d’E/S, qui est utilisée pour créer des files d’attente de soumission d’E/S.

La structure NVME_CDW11_CREATE_IO_SQ est utilisée dans le champ CDW11 du paramètre CREATEIOSQ de la structure Command .

Syntaxe

typedef union {
  struct {
    ULONG PC : 1;
    ULONG QPRIO : 2;
    ULONG Reserved0 : 13;
    ULONG CQID : 16;
  } DUMMYSTRUCTNAME;
  ULONG  AsUlong;
} NVME_CDW11_CREATE_IO_SQ, *PNVME_CDW11_CREATE_IO_SQ;

Membres

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.PC

Le champ PC indique si la file d’attente de soumission est physiquement contiguë en mémoire.

Lorsque cette valeur est définie sur 1, la file d’attente de soumission est physiquement contiguë et l’entrée PRP 1 (PRP1 dans la structure de données De commande) est l’adresse d’une mémoire tampon physique contiguë. Si la valeur est définie sur 0, la file d’attente de soumission n’est pas physiquement contiguë et PRP1 est un pointeur de liste PRP.

Si cette valeur est effacée 0 et que le champ Files d’attente contiguës requises (CQR) est défini sur 1 dans Fonctionnalités du contrôleur, le contrôleur doit retourner une status de NVME_STATUS_INVALID_FIELD_IN_COMMAND.

Si la file d’attente se trouve dans la mémoire tampon du contrôleur et que le PC est effacé pour 0, le contrôleur échoue à la commande avec un status de NVME_STATUS_INVALID_USE_OF_CONTROLLER_MEMORY_BUFFER.

DUMMYSTRUCTNAME.QPRIO

Le champ Priorité de la file d’attente (QPRIO) indique la classe de priorité à utiliser pour les commandes au sein de cette file d’attente de soumission en spécifiant une valeur d’énumération NVME_NVM_QUEUE_PRIORITIES .

Ce champ n’est utilisé que lorsque le tourniquet pondéré avec la classe priorité urgente est le mécanisme d’arbitrage sélectionné, le champ est ignoré si le tourniquet pondéré avec la classe priorité urgente n’est pas utilisé.

DUMMYSTRUCTNAME.Reserved0

DUMMYSTRUCTNAME.CQID

Le champ Identificateur de file d’attente (QID) indique l’identificateur de la file d’attente d’achèvement à utiliser pour toutes les entrées d’achèvement de commande associées à cette file d’attente de soumission.

La valeur de 0h (Administration file d’attente d’achèvement) ne doit pas être spécifiée.

Si la valeur spécifiée est 0h ou ne correspond pas à une file d’attente d’achèvement d’E/S valide, le contrôleur doit retourner une erreur de NVME_STATUS_INVALID_QUEUE_IDENTIFIER.

AsUlong

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
En-tête nvme.h

Voir aussi