union NVME_CDW10_CREATE_IO_QUEUE (nvme.h)
Contient les paramètres utilisés dans les commandes Créer une file d’attente d’achèvement d’E/S et Créer une file d’attente de soumission d’E/S. La commande Créer une file d’attente d’achèvement d’E/S est utilisée pour créer toutes les files d’attente d’achèvement d’E/S à l’exception de la file d’attente d’achèvement Administration et la commande Créer une file d’attente de soumission d’E/S est utilisée pour créer des files d’attente de soumission d’E/S.
La structure NVME_CDW10_CREATE_IO_QUEUE est utilisée dans le champ CDW10 des paramètres CREATEIOCQ et CREATEIOSQ de la structure Command .
Syntaxe
typedef union {
struct {
ULONG QID : 16;
ULONG QSIZE : 16;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} NVME_CDW10_CREATE_IO_QUEUE, *PNVME_CDW10_CREATE_IO_QUEUE;
Membres
DUMMYSTRUCTNAME
DUMMYSTRUCTNAME.QID
Le champ Identificateur de file d’attente (QID) indique l’identificateur à affecter à la file d’attente d’achèvement ou à la file d’attente de soumission à créer.
Cet identificateur correspond à la sonnerie de tête de file d’attente d’achèvement utilisée pour la commande Queue d’achèvement ou à la sonnette de queue de soumission utilisée pour la commande File d’attente de soumission.
Cette valeur d’ID 16 bits ne doit pas dépasser la valeur indiquée dans la fonctionnalité NVME_FEATURE_NUMBER_OF_QUEUES pour les files d’attente d’achèvement d’E/S ou les files d’attente de soumission d’E/S. Si la valeur spécifiée est 0h, dépasse le nombre de files d’attente signalées ou correspond à un identificateur déjà utilisé, le contrôleur doit retourner une erreur de NVME_STATUS_INVALID_QUEUE_IDENTIFIER.
DUMMYSTRUCTNAME.QSIZE
Le champ Taille de la file d’attente (QSIZE) indique la taille de la file d’attente d’achèvement ou de la file d’attente de soumission à créer. La taille de la file d’attente est indiquée dans un champ basé sur 0 16 bits qui spécifie le nombre d’entrées dans la file d’attente.
La taille minimale d’une file d’attente est de deux entrées. La taille maximale d’une file d’attente de soumission d’E/S ou d’une file d’attente d’achèvement d’E/S est de 64 000 entrées, limitée par la taille de file d’attente maximale prise en charge par le contrôleur qui est signalée dans le champ Maximum Queue Entries Supported (MQES) de la structure NVME_CONTROLLER_CAPABILITIES .
La taille maximale de la Administration Soumission et Administration File d’attente d’achèvement est définie sous la forme d’entrées 4K. Une entrée dans chaque file d’attente n’est pas disponible en raison de la définition du pointeur d’entrée Head et Tail.
Si la taille est 0h ou supérieure à celle prise en charge par le contrôleur, le contrôleur doit retourner une erreur de taille de file d’attente non valide.
AsUlong
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| En-tête | nvme.h |