VDS_VOLUME_PROP2 structure (vds.h)

Article
03/06/2024

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Définit les propriétés d’un objet volume. Cette structure est identique à la structure VDS_VOLUME_PROP , à ceci près qu’elle inclut également les GUID de volume.

Syntaxe

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

Membres

id

GUID du volume.

type

Valeur d’énumération VDS_VOLUME_TYPE qui spécifie le type de volume. Les types de volumes sont simples, délimités, rayés (RAID-0), mis en miroir ou rayés avec parité (RAID-5).

status

Valeur d’énumération VDS_VOLUME_STATUS qui spécifie le status du volume.

health

Valeur d’énumération VDS_HEALTH qui spécifie l’état d’intégrité du volume.

TransitionState

Valeur d’énumération VDS_TRANSITION_STATE qui spécifie l’état de transition du volume.

ullSize

Taille du volume, en octets.

ulFlags

Masque de bits de VDS_VOLUME_FLAG valeurs d’énumération qui décrivent le volume.

RecommendedFileSystemType

Valeur d’énumération VDS_FILE_SYSTEM_TYPE qui spécifie le système de fichiers préféré pour le volume. Doit être l’une des suivantes : VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS ou VDS_FST_UNKNOWN.

cbUniqueId

Longueur du tableau d’octets vers lequel pointe le membre pUniqueId .

pwszName

Nom utilisé pour ouvrir un handle pour le volume avec la fonction CreateFile . Par exemple, \ ?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Tableau d’octets qui contient l’identificateur unique du volume.

Remarques

La méthode IVdsVolume2 ::GetProperties2 retourne cette structure pour signaler les propriétés d’un objet volume.

Lorsqu’un volume est hors connexion, l’indicateur VDS_VF_PERMANENTLY_DISMOUNTED est défini dans le membre ulFlags de la structure VDS_VOLUME_PROP2, et la valeur VDS_VS_OFFLINE volume status est également définie dans le membre status de cette structure.

Pour les volumes GPT et dynamiques, l’identificateur unique vers lequel pointe le membre pUniqueId est globalement unique.

Pour les lecteurs multimédias amovibles, le volume existe et a son propre identificateur unique même s’il n’y a pas de média dans l’appareil. Si un volume est mis en forme sur un support amovible, ce volume a son propre identificateur unique. Pour plus d’informations, consultez Prise en charge des demandes mount Manager dans un pilote de classe de stockage.

Le format de l’identificateur unique peut varier selon les types d’appareils et de volumes. Pour les volumes de base sur les disques MBR, l’identificateur unique est basé sur la signature de disque et le décalage de partition. Étant donné que la signature de disque et le décalage de partition sont des valeurs DWORD, l’identificateur unique ne peut pas être garanti comme étant globalement unique entre les ordinateurs.

Si la signature du disque change, l’identificateur unique du volume change également. Les modifications de signature de disque se produisent généralement à la suite d’une collision pendant le clonage de disque.

Notez qu’un identificateur unique n’est pas le même qu’un chemin d’accès GUID de volume. Pour rechercher les chemins d’accès GUID d’un volume, utilisez la méthode IVdsVolumeMF3 ::QueryVolumeGuidPathnames .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	vds.h