structure GET_VIRTUAL_DISK_INFO (virtdisk.h)
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 |
|---|---|
|
Fixe. |
|
Extensible dynamiquement (éparse). |
|
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 |