structure GET_VIRTUAL_DISK_INFO (virtdisk.h)

  • Article

Contient des informations sur le disque dur virtuel (VHD).

Syntaxe

typedef struct _GET_VIRTUAL_DISK_INFO {
  GET_VIRTUAL_DISK_INFO_VERSION Version;
  union {
    struct {
      ULONGLONG VirtualSize;
      ULONGLONG PhysicalSize;
      ULONG     BlockSize;
      ULONG     SectorSize;
    } Size;
    GUID                 Identifier;
    struct {
      BOOL  ParentResolved;
      WCHAR ParentLocationBuffer[1];
    } ParentLocation;
    GUID                 ParentIdentifier;
    ULONG                ParentTimestamp;
    VIRTUAL_STORAGE_TYPE VirtualStorageType;
    ULONG                ProviderSubtype;
    BOOL                 Is4kAligned;
    BOOL                 IsLoaded;
    struct {
      ULONG LogicalSectorSize;
      ULONG PhysicalSectorSize;
      BOOL  IsRemote;
    } PhysicalDisk;
    ULONG                VhdPhysicalSectorSize;
    ULONGLONG            SmallestSafeVirtualSize;
    ULONG                FragmentationPercentage;
    GUID                 VirtualDiskId;
    struct {
      BOOL  Enabled;
      BOOL  NewerChanges;
      WCHAR MostRecentId[1];
    } ChangeTrackingState;
  };
} GET_VIRTUAL_DISK_INFO, *PGET_VIRTUAL_DISK_INFO;

Membres

Version

Valeur de l’énumération GET_VIRTUAL_DISK_INFO_VERSION qui spécifie la version de la structure GET_VIRTUAL_DISK_INFO transmise aux fonctions de disque virtuel ou à partir de celle-ci. Cela détermine les parties de cette structure qui seront utilisées.

Size

Structure avec les membres suivants. Définissez le membre Versionsur GET_VIRTUAL_DISK_INFO_SIZE.

Size.VirtualSize

Taille virtuelle du disque virtuel, en octets.

Size.PhysicalSize

Taille physique du disque virtuel sur le disque physique, en octets.

Size.BlockSize

Taille de bloc du disque virtuel, en octets.

Size.SectorSize

Taille du secteur du disque virtuel, en octets.

Identifier

Identificateur unique du disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_IDENTIFIER.

ParentLocation

Structure avec les membres suivants. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_PARENT_LOCATION.

ParentLocation.ParentResolved

Résolution parente. TRUE si le magasin de stockage parent a été correctement résolu, FALSE si ce n’est pas le cas.

ParentLocation.ParentLocationBuffer[1]

Si le membre ParentResolved a la valeur TRUE, contient le chemin d’accès du magasin de stockage parent.

Si le membre ParentResolved a la valeur FALSE, contient tous les chemins d’accès parent présents dans la liste de recherche.

ParentIdentifier

Identificateur unique du magasin de stockage de disque parent. Définissez le membre Versionsur GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER.

ParentTimestamp

Horodatage interne du magasin de stockage de disque parent. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP.

VirtualStorageType

VIRTUAL_STORAGE_TYPE structure contenant des informations sur le type de disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE.

ProviderSubtype

Sous-type spécifique au fournisseur. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE.

Valeur Signification
2
 Fixe.
3
 Extensible dynamiquement (éparse).
4
 Différenciation.

Is4kAligned

Indique si le disque virtuel est aligné de 4 Ko. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED.

Windows 7 et Windows Server 2008 R2 : Cela n’est pas pris en charge avant Windows 8 et Windows Server 2012.

IsLoaded

Indique si le disque virtuel est actuellement monté et en cours d’utilisation. TRUE si le disque virtuel est actuellement monté et en cours d’utilisation ; sinon , FALSE. Définissez le membre Versionsur GET_VIRTUAL_DISK_INFO_IS_LOADED.

Windows 8 et Windows Server 2012 : cette option n’est pas prise en charge avant Windows 8.1 et Windows Server 2012 R2.

PhysicalDisk

Détails sur le disque physique sur lequel réside le disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK.

Windows 7 et Windows Server 2008 R2 : Cela n’est pas pris en charge avant Windows 8 et Windows Server 2012.

PhysicalDisk.LogicalSectorSize

Taille du secteur logique du disque physique.

PhysicalDisk.PhysicalSectorSize

Taille du secteur physique du disque physique.

PhysicalDisk.IsRemote

Indique si le disque physique est distant.

VhdPhysicalSectorSize

Taille du secteur physique du disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE.

Windows 7 et Windows Server 2008 R2 : Cela n’est pas pris en charge avant Windows 8 et Windows Server 2012.

SmallestSafeVirtualSize

Taille minimale sécurisée la plus petite du disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE.

Windows 7 et Windows Server 2008 R2 : Cela n’est pas pris en charge avant Windows 8 et Windows Server 2012.

FragmentationPercentage

Niveau de fragmentation du disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_FRAGMENTATION.

Windows 7 et Windows Server 2008 R2 : Cela n’est pas pris en charge avant Windows 8 et Windows Server 2012.

VirtualDiskId

Identificateur créé de manière unique lorsqu’un utilisateur crée pour la première fois le disque virtuel pour tenter d’identifier ce disque virtuel de manière unique. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID.

Windows 8 et Windows Server 2012 : cette option n’est pas prise en charge avant Windows 8.1 et Windows Server 2012 R2.

ChangeTrackingState

État du suivi des modifications résilient (RCT) pour le disque virtuel. Définissez le membre Version sur GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE.

Windows 8.1 et Windows Server 2012 R2 : ce membre n’est pas pris en charge avant Windows 10 et Windows Server 2016.

ChangeTrackingState.Enabled

Indique si rcT est activé. TRUE si RCT est activé ; sinon , FALSE.

ChangeTrackingState.NewerChanges

Indique si le disque virtuel a changé depuis que la modification identifiée par le membre MostRecentId s’est produite. TRUE si le disque virtuel a changé depuis que la modification identifiée par le membre MostRecentId s’est produite ; sinon , FALSE.

ChangeTrackingState.MostRecentId[1]

Identificateur de suivi des modifications pour la modification qui identifie l’état du disque virtuel que vous souhaitez utiliser comme base de comparaison pour déterminer si le membre NewerChanges signale de nouvelles modifications.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7
Serveur minimal pris en charge Windows Server 2008 R2
En-tête virtdisk.h

Voir aussi

À propos du disque dur virtuel

GET_VIRTUAL_DISK_INFO_VERSION

GetVirtualDiskInformation

Référence du disque dur virtuel