structure CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)
Contient des paramètres de création de disque dur virtuel (VHD), qui fournissent un contrôle et des informations sur le disque virtuel nouvellement créé.
Syntaxe
typedef struct _CREATE_VIRTUAL_DISK_PARAMETERS {
CREATE_VIRTUAL_DISK_VERSION Version;
union {
struct {
GUID UniqueId;
ULONGLONG MaximumSize;
ULONG BlockSizeInBytes;
ULONG SectorSizeInBytes;
PCWSTR ParentPath;
PCWSTR SourcePath;
} Version1;
struct {
GUID UniqueId;
ULONGLONG MaximumSize;
ULONG BlockSizeInBytes;
ULONG SectorSizeInBytes;
ULONG PhysicalSectorSizeInBytes;
PCWSTR ParentPath;
PCWSTR SourcePath;
OPEN_VIRTUAL_DISK_FLAG OpenFlags;
VIRTUAL_STORAGE_TYPE ParentVirtualStorageType;
VIRTUAL_STORAGE_TYPE SourceVirtualStorageType;
GUID ResiliencyGuid;
} Version2;
};
} CREATE_VIRTUAL_DISK_PARAMETERS, *PCREATE_VIRTUAL_DISK_PARAMETERS;
Membres
Version
Valeur de l’énumération CREATE_VIRTUAL_DISK_VERSION qui est le discriminant pour l’union.
| Valeur | Signification |
|---|---|
|
Utilisez le membre Version1 de cette structure. |
|
Utilisez le membre Version2 de cette structure. |
Version1
Cette structure est utilisée si le membre Version est CREATE_VIRTUAL_DISK_VERSION_1 (1).
Version1.UniqueId
Identificateur unique à affecter à l’objet de disque virtuel. Si ce membre est défini sur zéro, un identificateur unique est créé par le système.
Version1.MaximumSize
Taille virtuelle maximale, en octets, de l’objet de disque virtuel. Doit être un multiple de 512.
Si un ParentPath est spécifié, cette valeur doit être égale à zéro.
Si un SourcePath est spécifié, cette valeur peut être égale à zéro pour spécifier la taille du disque virtuel source à utiliser. Sinon, la taille spécifiée doit être supérieure ou égale à la taille du disque source.
Version1.BlockSizeInBytes
Taille interne des blocs d’objet de disque virtuel, en octets. Cette valeur doit être définie sur l’une des valeurs suivantes.
Version1.SectorSizeInBytes
Taille interne des secteurs d’objets de disque virtuel. Doit être défini sur 512.
| Valeur | Signification |
|---|---|
|
Taille par défaut et uniquement autorisée, 512 octets. |
Version1.ParentPath
Chemin d’accès complet facultatif à un objet de disque virtuel parent. Associe le nouveau disque virtuel à un disque virtuel existant.
Si ce paramètre n’est pas NULL, SourcePath doit avoir la valeur NULL.
Version1.SourcePath
Chemin d’accès complet facultatif pour préremplir le nouvel objet de disque virtuel avec les données de bloc d’un disque existant. Ce chemin d’accès peut faire référence à un disque virtuel ou à un disque physique.
Si ce paramètre n’est pas NULL, ParentPath doit avoir la valeur NULL.
Version2
Cette structure est utilisée si le membre Version est CREATE_VIRTUAL_DISK_VERSION_2 (2).
Windows 7 et Windows Server 2008 R2 : Cette structure n’est prise en charge qu’après Windows 8 et Windows Server 2012.
Version2.UniqueId
Identificateur unique à affecter à l’objet de disque virtuel. Si ce membre est défini sur zéro, un identificateur unique est créé par le système.
Version2.MaximumSize
Taille virtuelle maximale, en octets, de l’objet de disque virtuel. Doit être un multiple de 512.
Si un ParentPath est spécifié, cette valeur doit être égale à zéro.
Si un SourcePath est spécifié, cette valeur peut être égale à zéro pour spécifier la taille du disque virtuel source à utiliser. Sinon, la taille spécifiée doit être supérieure ou égale à la taille du disque source.
Version2.BlockSizeInBytes
Taille interne des blocs d’objet de disque virtuel, en octets. Pour VHDX, il doit s’agir d’un multiple de 1 Mo compris entre 1 et 256 Mo. Pour le disque dur virtuel 1, il doit être défini sur l’une des valeurs suivantes.
Version2.SectorSizeInBytes
Taille interne des secteurs d’objets de disque virtuel. Pour VHDX doit être défini sur 512 (0x200) ou 4096 (0x1000). Pour le disque dur virtuel 1 doit être défini sur 512.
Version2.PhysicalSectorSizeInBytes
Version2.ParentPath
Chemin d’accès complet facultatif à un objet de disque virtuel parent. Associe le nouveau disque virtuel à un disque virtuel existant.
Si ce paramètre n’est pas NULL, SourcePath doit avoir la valeur NULL.
Version2.SourcePath
Chemin d’accès complet facultatif pour préremplir le nouvel objet de disque virtuel avec les données de bloc d’un disque existant. Ce chemin d’accès peut faire référence à un disque virtuel ou à un disque physique.
Si ce paramètre n’est pas NULL, ParentPath doit avoir la valeur NULL.
Version2.OpenFlags
Zéro ou plusieurs indicateurs de l’énumération OPEN_VIRTUAL_DISK_FLAG décrivant la façon dont le disque virtuel doit être ouvert.
Version2.ParentVirtualStorageType
Structure VIRTUAL_STORAGE_TYPE décrivant le disque virtuel parent spécifié dans le membre ParentPath .
Version2.SourceVirtualStorageType
Structure VIRTUAL_STORAGE_TYPE décrivant le disque virtuel source spécifié dans le membre SourcePath .
Version2.ResiliencyGuid
GUID de résilience pour le fichier.
Notes
Les paramètres suivants, préfacés version3 et version4, sont destinés à une utilisation interne.
Version3
Version3.UniqueId
Version3.MaximumSize
Version3.BlockSizeInBytes
Version3.SectorSizeInBytes
Version3.PhysicalSectorSizeInBytes
Version3.ParentPath
Version3.SourcePath
Version3.OpenFlags
Version3.ParentVirtualStorageType
Version3.SourceVirtualStorageType
Version3.ResiliencyGuid
Version3.SourceLimitPath
Version3.BackingStorageType
Version4
Version4.UniqueId
Version4.MaximumSize
Version4.BlockSizeInBytes
Version4.SectorSizeInBytes
Version4.PhysicalSectorSizeInBytes
Version4.ParentPath
Version4.SourcePath
Version4.OpenFlags
Version4.ParentVirtualStorageType
Version4.SourceVirtualStorageType
Version4.ResiliencyGuid
Version4.SourceLimitPath
Version4.BackingStorageType
Version4.PmemAddressAbstractionType
Version4.DataAlignment
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
Nommage des fichiers, des chemins et des espaces de noms