structure SET_VIRTUAL_DISK_INFO (virtdisk.h)

Article
03/03/2024

Contient des informations sur le disque dur virtuel (VHD) à utiliser lorsque vous appelez la fonction SetVirtualDiskInformation pour définir les propriétés du disque dur virtuel.

Syntaxe

typedef struct _SET_VIRTUAL_DISK_INFO {
  SET_VIRTUAL_DISK_INFO_VERSION Version;
  union {
    PCWSTR ParentFilePath;
    GUID   UniqueIdentifier;
    struct {
      ULONG  ChildDepth;
      PCWSTR ParentFilePath;
    } ParentPathWithDepthInfo;
    ULONG  VhdPhysicalSectorSize;
    GUID   VirtualDiskId;
    BOOL   ChangeTrackingEnabled;
    struct {
      GUID   LinkageId;
      PCWSTR ParentFilePath;
    } ParentLocator;
  };
} SET_VIRTUAL_DISK_INFO, *PSET_VIRTUAL_DISK_INFO;

Membres

Version

Énumération SET_VIRTUAL_DISK_INFO_VERSION qui spécifie la version de la structure SET_VIRTUAL_DISK_INFO transmise aux fonctions VHD ou à partir de celle-ci. Cela détermine le type d’ensemble d’informations.

ParentFilePath

Chemin d’accès au magasin de stockage parent. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_PARENT_PATH (1).

UniqueIdentifier

Identificateur unique du disque dur virtuel. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_IDENTIFIER (2).

ParentPathWithDepthInfo

Définit le chemin du fichier parent et la profondeur enfant. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_PARENT_PATH_WITH_DEPTH (3).

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

ParentPathWithDepthInfo.ChildDepth

Spécifie la profondeur de l’enfant à partir de la feuille. La feuille elle-même est à la profondeur 1.

ParentPathWithDepthInfo.ParentFilePath

Spécifie la profondeur du parent à partir de la feuille. La feuille elle-même est à la profondeur 1.

VhdPhysicalSectorSize

Définit la taille du secteur physique signalée par le disque dur virtuel. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_PHYSICAL_SECTOR_SIZE (4). 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 Versionsur SET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID (5).

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

ChangeTrackingEnabled

Active ou désactive le suivi des modifications résilient (RCT) pour le disque dur virtuel. TRUE active RCT. FALSE désactive RCT. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE (6).

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

ParentLocator

Définit les informations de liaison parentes que les disques durs virtuels de différenciation stockent. Les informations de liaison parent sont des métadonnées utilisées pour localiser et identifier correctement le parent suivant dans la chaîne de disques virtuelle. Définissez le membre Versionsur SET_VIRTUAL_DISK_INFO_PARENT_LOCATOR (7).

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

ParentLocator.LinkageId

Identificateur unique pour les informations de liaison parente.

ParentLocator.ParentFilePath

Chemin du fichier pour le disque dur virtuel parent.

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

Référence du disque dur virtuel

Partager via