CREATE_VIRTUAL_DISK_PARAMETERS-Struktur (virtdisk.h)

  • Artikel

Enthält Parameter für die Erstellung virtueller Festplatten (VHD), die Kontrolle über den neu erstellten virtuellen Datenträger und Informationen über den neu erstellten virtuellen Datenträger bieten.

Syntax

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;

Member

Version

Ein Wert aus der CREATE_VIRTUAL_DISK_VERSION Enumeration, die für die Union diskriminant ist.

Wert Bedeutung
CREATE_VIRTUAL_DISK_VERSION_1
1
 Verwenden Sie das Version1-Element dieser Struktur.
CREATE_VIRTUAL_DISK_VERSION_2
2
 Verwenden Sie das Version2-Element dieser Struktur.

Version1

Diese Struktur wird verwendet, wenn das VersionselementCREATE_VIRTUAL_DISK_VERSION_1 (1) ist.

Version1.UniqueId

Eindeutiger Bezeichner, der dem objekt des virtuellen Datenträgers zugewiesen werden soll. Wenn dieser Member auf 0 festgelegt ist, wird vom System ein eindeutiger Bezeichner erstellt.

Version1.MaximumSize

Die maximale virtuelle Größe des virtuellen Datenträgerobjekts in Bytes. Muss ein Vielfaches von 512 sein.

Wenn ein ParentPath angegeben wird, muss dieser Wert 0 sein.

Wenn ein SourcePath angegeben wird, kann dieser Wert null sein, um die Größe des zu verwendenden virtuellen Quelldatenträgers anzugeben. Andernfalls muss die angegebene Größe größer oder gleich der Größe des Quelldatenträgers sein.

Version1.BlockSizeInBytes

Interne Größe der Objektblöcke des virtuellen Datenträgers in Bytes. Dies muss auf einen der folgenden Werte festgelegt werden.

Wert Bedeutung
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 Dies ist der Standardwert und stellt eine Blockgröße von 2 MB dar.
524288 (0x80000)
 Die Blockgröße beträgt 512 KB.
2097152 (0x200000)
 Die Blockgröße beträgt 2 MB

Version1.SectorSizeInBytes

Interne Größe der Sektoren des virtuellen Datenträgerobjekts. Muss auf 512 festgelegt werden.

Wert Bedeutung
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_SECTOR_SIZE
0x200
 Die standard- und nur zulässige Größe, 512 Bytes.

Version1.ParentPath

Optionaler vollqualifizierter Pfad zu einem übergeordneten virtuellen Datenträgerobjekt. Ordnet den neuen virtuellen Datenträger einem vorhandenen virtuellen Datenträger zu.

Wenn dieser Parameter nicht NULL ist, muss SourcePathNULL sein.

Version1.SourcePath

Optionaler vollqualifizierter Pfad zum Vorabbefüllen des neuen virtuellen Datenträgerobjekts mit Blockdaten von einem vorhandenen Datenträger. Dieser Pfad kann auf einen virtuellen Datenträger oder einen physischen Datenträger verweisen.

Wenn dieser Parameter nicht NULL ist, muss ParentPathNULL sein.

Version2

Diese Struktur wird verwendet, wenn das VersionselementCREATE_VIRTUAL_DISK_VERSION_2 (2) ist.

Windows 7 und Windows Server 2008 R2: Diese Struktur wird erst unterstützt, wenn Windows 8 und Windows Server 2012.

Version2.UniqueId

Eindeutiger Bezeichner, der dem objekt des virtuellen Datenträgers zugewiesen werden soll. Wenn dieser Member auf 0 festgelegt ist, wird vom System ein eindeutiger Bezeichner erstellt.

Version2.MaximumSize

Die maximale virtuelle Größe des virtuellen Datenträgerobjekts in Bytes. Muss ein Vielfaches von 512 sein.

Wenn ein ParentPath angegeben wird, muss dieser Wert 0 sein.

Wenn ein SourcePath angegeben wird, kann dieser Wert null sein, um die Größe des zu verwendenden virtuellen Quelldatenträgers anzugeben. Andernfalls muss die angegebene Größe größer oder gleich der Größe des Quelldatenträgers sein.

Version2.BlockSizeInBytes

Interne Größe der Objektblöcke des virtuellen Datenträgers in Bytes. Für VHDX muss dies ein Vielfaches von 1 MB zwischen 1 und 256 MB sein. Für VHD 1 muss dies auf einen der folgenden Werte festgelegt werden.

Wert Bedeutung
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 Dies ist der Standardwert und stellt eine Blockgröße von 2 MB dar. Dies ist der einzige unterstützte Wert für feste virtuelle VHD 1-Datenträger.
524288 (0x80000)
 Die Blockgröße beträgt 512 KB. Dieser Wert wird auf virtuellen Datenträgern mit fester VHD 1 nicht unterstützt.
2097152 (0x200000)
 Die Blockgröße beträgt 2 MB. Dieser Wert wird auf virtuellen Datenträgern mit fester VHD 1 nicht unterstützt.

Version2.SectorSizeInBytes

Interne Größe der Sektoren des virtuellen Datenträgerobjekts. Für VHDX muss auf 512 (0x200) oder 4096 (0x1000) festgelegt werden. Für VHD muss 1 auf 512 festgelegt werden.

Version2.PhysicalSectorSizeInBytes

Version2.ParentPath

Optionaler vollqualifizierter Pfad zu einem übergeordneten virtuellen Datenträgerobjekt. Ordnet den neuen virtuellen Datenträger einem vorhandenen virtuellen Datenträger zu.

Wenn dieser Parameter nicht NULL ist, muss SourcePathNULL sein.

Version2.SourcePath

Optionaler vollqualifizierter Pfad zum Vorabbefüllen des neuen virtuellen Datenträgerobjekts mit Blockdaten von einem vorhandenen Datenträger. Dieser Pfad kann auf einen virtuellen Datenträger oder einen physischen Datenträger verweisen.

Wenn dieser Parameter nicht NULL ist, muss ParentPathNULL sein.

Version2.OpenFlags

Null oder mehr Flags aus der OPEN_VIRTUAL_DISK_FLAG Enumeration, die beschreibt, wie der virtuelle Datenträger geöffnet werden soll.

Version2.ParentVirtualStorageType

Eine VIRTUAL_STORAGE_TYPE Struktur, die den übergeordneten virtuellen Datenträger beschreibt, der im ParentPath-Member angegeben ist.

Version2.SourceVirtualStorageType

Eine VIRTUAL_STORAGE_TYPE Struktur, die den virtuellen Quelldatenträger beschreibt, der im SourcePath-Member angegeben ist.

Version2.ResiliencyGuid

Resilienz-GUID für die Datei.

Hinweis

Die folgenden Parameter, denen Version 3 und Version4 vorangestellt sind, sind für die interne Verwendung vorgesehen.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Kopfzeile virtdisk.h

Weitere Informationen

Informationen zu VHD

CreateVirtualDisk

Benennen von Dateien, Pfaden und Namespaces

VHD-Referenz

VHD-Strukturen