union NVME_CDW10_FORMAT_NVM (nvme.h)
Contient les paramètres de la commande Formater NVM utilisée pour mettre en forme le média NVM de bas niveau.
Cette commande est utilisée lorsque l’hôte souhaite modifier la taille des données de l’adresse de bloc logique (LBA) et/ou la taille des métadonnées. Un format de bas niveau peut détruire toutes les données et métadonnées associées à tous les espaces de noms ou uniquement l’espace de noms spécifique associé à la commande (reportez-vous au format attributs NVM dans le champ Facultatif Administration Command Support (OACS) de la structure de données Identifier le contrôleur de données). Une fois la commande Formater NVM terminée, le contrôleur ne retourne aucune donnée utilisateur précédemment contenue dans un espace de noms affecté.
La commande Format NVM utilise le champ CDW10 Commande Dword 10 dans le paramètre FORMATNVM de la structure Command . Tous les autres champs spécifiques aux commandes sont réservés.
Syntaxe
typedef union {
struct {
ULONG LBAF : 4;
ULONG MS : 1;
ULONG PI : 3;
ULONG PIL : 1;
ULONG SES : 3;
ULONG ZF : 2;
ULONG Reserved : 18;
} DUMMYSTRUCTNAME;
ULONG AsUlong;
} NVME_CDW10_FORMAT_NVM, *PNVME_CDW10_FORMAT_NVM;
Membres
DUMMYSTRUCTNAME
DUMMYSTRUCTNAME.LBAF
Valeur NVME_LBA_FORMAT qui spécifie le format LBA à appliquer au média NVM. Seuls les formats LBA pris en charge peuvent être sélectionnés. Cette valeur correspond au champ LBAF dans la structure NVME_IDENTIFY_NAMESPACE_DATA de la commande Identifier.
DUMMYSTRUCTNAME.MS
Spécifie les paramètres de métadonnées.
Lorsque ce champ est défini sur 1 si les métadonnées sont transférées dans le cadre d’un LBA de données étendu. Ce champ est effacé 0 si les métadonnées sont transférées dans le cadre d’une mémoire tampon distincte. Les métadonnées peuvent inclure des informations de protection, basées sur le champ Informations de protection (PI). Si le champ Taille des métadonnées MS du format LBA sélectionné est 0h, ce champ n’est pas applicable.
DUMMYSTRUCTNAME.PI
Valeur d’énumération NVME_PROTECTION_INFORMATION_TYPES qui spécifie si la protection des données de bout en bout est activée et le type d’informations de protection.
DUMMYSTRUCTNAME.PIL
Spécifie l’emplacement des informations de protection.
Si cette valeur est définie 1 sur et que les informations de protection sont activées, les informations de protection sont transférées en tant que huit premiers octets de métadonnées. Si elles sont effacées vers 0 et que les informations de protection sont activées, les informations de protection sont transférées en tant que huit derniers octets de métadonnées. Ce paramètre est signalé dans le champ LBAF Taille de LBA mise en forme de la structure de données Identifier l’espace de noms.
DUMMYSTRUCTNAME.SES
Valeur d’énumération NVME_SECURE_ERASE_SETTINGS qui spécifie si une effacement sécurisé doit être effectuée dans le cadre du format et du type de l’opération d’effacement sécurisée. L’effacement s’applique à toutes les données utilisateur, quel que soit l’emplacement. Par exemple, au sein d’un LBA exposé, d’un cache ou d’un LBA désalloué.
DUMMYSTRUCTNAME.ZF
DUMMYSTRUCTNAME.Reserved
AsUlong
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| En-tête | nvme.h |