Partager via

classe MSFT_Disk

  • Article

Représente un disque Windows.

Un objet MSFT_Disk modélise le concept du système d’exploitation Windows d’un appareil disque. Le disque peut être directement attaché au système informatique, ou il peut s’agir d’un disque virtuel exposé au système via l’utilisation d’un fournisseur de gestion du stockage.

La syntaxe suivante est simplifiée à partir du code du format d’objet géré (MOF).

Syntaxe

class MSFT_Disk : MSFT_StorageObject
{
  String  Path;
  String  Location;
  String  FriendlyName;
  String  UniqueId;
  UInt16  UniqueIdFormat;
  UInt32  Number;
  String  SerialNumber;
  String  FirmwareVersion;
  String  Manufacturer;
  String  Model;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt32  LogicalSectorSize;
  UInt32  PhysicalSectorSize;
  UInt64  LargestFreeExtent;
  UInt32  NumberOfPartitions;
  UInt16  ProvisioningType;
  UInt16  OperationalStatus;
  UInt16  HealthStatus;
  UInt16  BusType;
  UInt16  PartitionStyle;
  UInt32  Signature;
  String  Guid;
  Boolean IsOffline;
  UInt16  OfflineReason;
  Boolean IsReadOnly;
  Boolean IsSystem;
  Boolean IsClustered;
  Boolean IsBoot;
  Boolean BootFromDisk;
};

Membres

La classe MSFT_Disk a ces types de membres :

Méthodes

La classe MSFT_Disk a ces méthodes.

Méthode Description
Clear Supprime les informations de partition et annule l’initialisation d’un disque, en le retournant à un état RAW.
ConvertStyle Convertit le style de partition d’un disque déjà initialisé.
CreatePartition Crée une partition sur un disque.
Initialize Initialise un disque RAW avec un style de partition particulier.
Hors connexion Met le disque hors connexion.
En ligne Met le disque en ligne.
Actualiser Actualise les informations de disposition du disque mis en cache.
SetAttributes Définit les attributs et les propriétés du disque.

Propriétés

La classe MSFT_Disk possède ces propriétés.

AllocatedSize

Type de données : UInt64

Type d’accès : Lecture seule

Qualificateurs : Requis, Unités (octets)

Quantité d’espace, en octets, actuellement utilisée sur le disque.

BootFromDisk

Type de données : booléen

Type d’accès : Lecture seule

TRUE si l’ordinateur est configuré pour démarrer à partir de ce disque. Sur les ordinateurs avec microprogramme BIOS, il s’agit du premier disque détecté par le microprogramme au démarrage. Sur les ordinateurs qui utilisent le microprogramme EFI, il s’agit du disque qui contient la partition système EFI (ESP). S’il n’existe aucun disque ou s’il existe plusieurs disques avec une partition ESP, cette propriété n’est définie pour aucun disque.

BusType

Type de données : UInt16

Type d’accès : Lecture seule

Type de bus d’E/S utilisé par le disque.

Valeur Signification
Unknown 0 Le type de bus est inconnu.
SCSI 1 SCSI
ATAPI 2 ATAPI
ATA 3 ATA
1394 4 IEEE 1394
SSA 5 SSA
Fibre Channel 6 Fibre Channel
USB 7 USB
RAID 8 RAID
iSCSI 9 iSCSI
SAP 10 Serial Attached SCSI (SAS)
SATA 11 Serial ATA (SATA)
SD 12 Secure Digital (SD)
MMC 13 Carte multimédia (MMC)
Virtual 14 Cette valeur est réservée à l’usage du système.
Fichier backed Virtual 15 File-Backed Virtual
espaces de stockage 16 Espaces de stockage
NVMe 17 NVMe

FirmwareVersion

Type de données : Chaîne

Type d’accès : Lecture seule

Représentation sous forme de chaîne de la version du microprogramme du disque.

FriendlyName

Type de données : Chaîne

Type d’accès : Lecture seule

Qualificateurs : obligatoire

Chaîne orientée utilisateur orientée affichage pour identifier le disque.

Guid

Type de données : Chaîne

Type d’accès : Lecture seule

Si PartitionStyle est GPT, cette propriété contient le GUID du disque. Cette propriété sera NULL pour tous les autres types de disques.

HealthStatus

Type de données : UInt16

Type d’accès : Lecture seule

État d’intégrité de l’appareil disque.

Valeur Signification
Healthy 0 Le disque fonctionne normalement.
Warning 1 Le disque fonctionne toujours, mais a détecté des erreurs ou des problèmes nécessitant une intervention de l’administrateur.
Unhealthy 2 Le volume ne fonctionne pas, en raison d’erreurs ou d’échecs. Le volume a besoin d’une attention immédiate d’un administrateur.

IsBoot

Type de données : booléen

Type d’accès : Lecture seule

TRUE si le disque contient la partition de démarrage.

IsClustered

Type de données : Boolean

Type d’accès : Lecture seule

TRUE si le disque est utilisé dans un environnement cluster ou FALSE sinon.

IsOffline

Type de données : booléen

Type d’accès : Lecture seule

TRUE si le disque est hors connexion ou FALSE dans le cas contraire.

IsReadOnly

Type de données : Boolean

Type d’accès : Lecture seule

TRUE si le disque est en lecture seule ou FALSE s’il est en lecture/écriture.

IsSystem

Type de données : booléen

Type d’accès : Lecture seule

TRUE si ce disque contient la partition système ou FALSE dans le cas contraire.

LargestFreeExtent

Type de données : UInt64

Type d’accès : Lecture seule

Qualificateurs : unités (octets)

Le plus grand bloc contigu d’espace libre sur le disque. Il s’agit également de la plus grande taille d’une partition qui peut être créée sur le disque.

Lieu

Type de données : Chaîne

Type d’accès : Lecture seule

Chaîne qui contient le chemin d’accès d’emplacement PnP du disque. Le format de cette chaîne dépend du type de bus. Si le type de bus est SCSI, SAS ou PCI RAID, le format est AdapterPnpLocationPath#BusType(PPathId TTargetIdLLunId). Si le type de bus est IDE, ATA, PATA ou SATA, le format est AdapterPnpLocationPath#BusType(CPathId TTargetIdLLunId). Consultez la section Remarques suivante pour un tableau qui répertorie les parties de cette chaîne.

Remarque

Pour les images Hyper-V et VHD, cette propriété a la valeur NULL, car le contrôleur virtuel ne retourne pas le chemin d’accès d’emplacement.

Pour plus d’informations sur cette propriété, consultez la section Remarques suivante.

LogicalSectorSize

Type de données : UInt32

Type d’accès : Lecture seule

Qualificateurs : unités (octets)

Taille du secteur logique du disque, en octets. Par exemple, un disque natif 4K signale 4096, tandis qu’un disque émulé 512 signale 512.

Fabricant

Type de données : Chaîne

Type d’accès : Lecture seule

Représentation sous forme de chaîne du fabricant du matériel du disque.

Modèle

Type de données : Chaîne

Type d’accès : Lecture seule

Représentation sous forme de chaîne du numéro de modèle du disque.

Nombre

Type de données : UInt32

Type d’accès : Lecture seule

Numéro du système d’exploitation pour le disque. Le disque 0 est généralement l’appareil de démarrage. Les numéros de disque peuvent ne pas nécessairement rester identiques entre les redémarrages.

NumberOfPartitions

Type de données : UInt32

Type d’accès : Lecture seule

Nombre de partitions créées sur le disque.

OfflineReason

Type de données : UInt16

Type d’accès : Lecture seule

Si IsOffline a la valeur TRUE, cette propriété contient la raison pour laquelle le disque est hors connexion.

Une des valeurs ci-dessous.

Valeur Signification
Stratégie 1 L’utilisateur a demandé que le disque soit hors connexion.
Chemin redondant 2 Le disque est utilisé pour les E/S multi-chemins.
Instantané 3 Le disque est un disque d’instantané.
Collision 4 Une collision de signature ou d’identificateur s’est produite avec un autre disque.
Épuisement des ressources 5 Il y avait des ressources insuffisantes pour mettre le disque en ligne.
Échecs d’écriture critiques 6 Des échecs d’écriture critiques ont été effectués sur le disque.
Analyse de l’intégrité des données requise 7 Une analyse de l’intégrité des données est requise.

OperationalStatus

Type de données : UInt16

Type d’accès : Lecture seule

État opérationnel de l’appareil disque.

Valeur Signification
Unknown 0 Le statut opérationnel est inconnu.
Other 1 Un OperationalStatus spécifique au fournisseur a été spécifié en définissant la propriété OtherOperationalStatusDescription.
OK 2 Le disque répond aux commandes et est dans un état d’exploitation normal.
Degraded 3 Le disque répond aux commandes, mais n’est pas en cours d’exécution dans un état d’exploitation optimal.
Stressed 4 Le disque fonctionne, mais a besoin d’attention. Par exemple, le disque peut être surchargé ou surchauffé.
Predictive Failure 5 Le disque fonctionne, mais un échec est susceptible de se produire dans un avenir proche.
Error 6 Une erreur s’est produite.
Non-Recoverable Error 7 Une erreur non récupérable s’est produite.
Starting 8 Le disque est en cours de démarrage.
Stopping 9 Le disque est en cours d’arrêt.
Stopped 10 Le disque a été arrêté ou arrêté de manière propre et ordonnée.
In Service 11 Le disque est en cours de configuration, de maintenance, de nettoyage ou d’administration.
No Contact 12 Le fournisseur de stockage a connaissance du disque, mais n’a jamais pu établir la communication avec lui.
Lost Communication 13 Le fournisseur de stockage a connaissance du disque et l’a contacté avec succès dans le passé, mais le disque est actuellement inaccessible.
Aborted 14 Similaire à Arrêté, sauf que le disque s’est arrêté brusquement et peut nécessiter une configuration ou une maintenance.
Dormant 15 Le disque est accessible, mais il est inactif.
Supporting Entity in Error 16 Cette valeur d’état n’indique pas nécessairement des problèmes avec le disque, mais elle indique qu’un autre appareil ou connexion dépend du disque peut avoir besoin d’attention.
Completed 17 Le disque a terminé une opération. Cette valeur d’état doit être combinée à OK, Erreur ou Détériorée, en fonction du résultat de l’opération.
0xD010 en ligne Dans les sous-systèmes de stockage Windows, cela indique que l’objet est en ligne.
Non prêt 0xD011 Dans les sous-systèmes de stockage Windows, cela indique que l’objet n’est pas prêt.
Aucun média 0xD012 Dans les sous-systèmes de stockage Windows, cela indique que l’objet n’a aucun support présent.
0xD013 hors connexion Dans les sous-systèmes de stockage Windows, cela indique que l’objet est hors connexion.
Échec 0xD014 Dans les sous-systèmes de stockage Windows, cela indique que l’objet est dans un état d’échec.

PartitionStyle

Type de données : UInt16

Type d’accès : Lecture seule

Qualificateurs : obligatoire

Style de partition utilisé par le disque.

Valeur Signification
Unknown 0 Le style de partition est inconnu.
MBR 1 Secteur de démarrage principal
GPT 2 GUID Partition Table (GPT)

Chemin d’accès

Type de données : Chaîne

Type d’accès : Lecture seule

Qualificateurs : obligatoire

Chemin d’accès qui peut être utilisé pour ouvrir un handle de système d’exploitation sur l’appareil disque.

PhysicalSectorSize

Type de données : UInt32

Type d’accès : Lecture seule

Qualificateurs : unités (octets)

Taille du secteur physique du disque, en octets. Par exemple, les disques natifs 4K et 512 disques émulés signalent 4096.

ProvisioningType

Type de données : UInt16

Type d’accès : Lecture seule

Type d’approvisionnement de l’appareil disque.

Valeur Signification
Unknown 0 Le schéma d’approvisionnement n’est pas spécifié.
Thin 1 Le stockage du disque est alloué à la demande.
Fixed 2 Le stockage est alloué lors de la création du disque.

SerialNumber

Type de données : Chaîne

Type d’accès : Lecture seule

Représentation sous forme de chaîne du numéro de série du disque.

Signature

Type de données : UInt32

Type d’accès : Lecture seule

Si partitionStyle est MBR, cette propriété contient la signature de partition MBR. Cette propriété sera NULL pour tous les autres types de disques.

Taille

Type de données : UInt64

Type d’accès : Lecture seule

Qualificateurs : Requis, Unités (octets)

Taille totale du disque, en octets.

UniqueId

Type de données : Chaîne

Type d’accès : Lecture seule

Identificateur de disque. Il contient la page VPD 0x83 informations qui identifient de manière unique ce disque. Les types suivants sont acceptés (par ordre de priorité) :

  • 8 (chaîne de nom SCSI)
  • 3 (nom FCPH)
  • 2 (EUI64)
  • 1 (ID du fournisseur)
  • 0 (Spécifique au fournisseur)

Si le disque est un disque virtuel exposé, uniqueId est utilisé pour mapper l’association entre les deux objets.

UniqueIdFormat

Type de données : UInt16

Type d’accès : Lecture seule

Qualificateurs : Valeurs ( « Vendor Specific », « Vendor Id », « EUI64 », « FCPH Name », « SCSI Name String », ValueMap (« 0 », « 1 », « 2 », « 3 », « 8 »)

Format de l’identificateur de disque. Cette propriété contient la page VPD 0x83 type de descripteur utilisé pour définir la propriété UniqueId .

Notes

Le tableau suivant répertorie les parties de la chaîne de chemin d’accès d’emplacement utilisée dans la propriété Location .

Partie chemin d’accès d’emplacement Description
AdapterPnpLocationPath Chemin d’accès d’emplacement PnP de l’adaptateur. Cette opération est récupérée en appelant la fonction SetupDiGetDeviceProperty , en passant &DEVPKEY_Device_LocationPaths pour le paramètre PropertyKey .
BusType Type de bus : ATA, RAID, SAS ou SCSI. Remarque : Si le type de bus est IDE, PATA ou SATA, il apparaît comme ATA dans la chaîne de chemin d’accès d’emplacement. S’il s’agit d’un RAID PCI, il apparaît en tant que RAID.
PathId Numéro du bus. Il s’agit de la valeur du membre PathId de la structure SCSI_ADDRESS retournée par le code de contrôle IOCTL_SCSI_GET_ADDRESS .
TargetId Numéro de l’appareil cible. Il s’agit de la valeur du membre TargetId de la structure SCSI_ADDRESS retournée par le code de contrôle IOCTL_SCSI_GET_ADDRESS .
LunId Numéro du numéro d’unité logique. Il s’agit de la valeur du membre Lun de la structure SCSI_ADDRESS retournée par le code de contrôle IOCTL_SCSI_GET_ADDRESS .

Le tableau suivant contient des exemples de chemins d’accès d’emplacement.

Type de bus Exemple de chemin d’accès à l’emplacement
ATA PCIROOT(0)#PCI(0100)#ATA(C01T03L00)
RAID PCIROOT(0)#PCI(0200)#PCI(0003)#PCI(0100)#RAID(P02T00L00)
SAS PCIROOT(1)#PCI(0300)#SAS(P00T03L00)
SCSI PCIROOT(0)#PCI(1C00)#PCI(0000)#SCSI(P00T01L01)

À compter de Windows 10 : MSFT_Disk dérive de MSFT_StorageObject. Il hérite maintenant de la propriété ObjectId, qui était anciennement une propriété de MSFT_Disk.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Espace de noms Root\Microsoft\Windows\Storage
MOF Storagewmi.mof