Bagikan melalui

struktur CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)

Berisi parameter pembuatan hard disk virtual (VHD), memberikan kontrol atas, dan informasi tentang, disk virtual yang baru dibuat.

Sintaks

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;

Anggota

Version

Nilai dari enumerasi CREATE_VIRTUAL_DISK_VERSION yang merupakan diskriminan untuk serikat pekerja.

Nilai Makna
CREATE_VIRTUAL_DISK_VERSION_1
1
 Gunakan anggota Versi1 dari struktur ini.
CREATE_VIRTUAL_DISK_VERSION_2
2
 Gunakan anggota Versi2 dari struktur ini.

Version1

Struktur ini digunakan jika anggota VersiCREATE_VIRTUAL_DISK_VERSION_1 (1).

Version1.UniqueId

Pengidentifikasi unik untuk ditetapkan ke objek disk virtual. Jika anggota ini diatur ke nol, pengidentifikasi unik dibuat oleh sistem.

Version1.MaximumSize

Ukuran virtual maksimum, dalam byte, dari objek disk virtual. Harus kelipatan 512.

Jika ParentPath ditentukan, nilai ini harus nol.

Jika SourcePath ditentukan, nilai ini bisa nol untuk menentukan ukuran disk virtual sumber yang akan digunakan, jika tidak, ukuran yang ditentukan harus lebih besar dari atau sama dengan ukuran disk sumber.

Version1.BlockSizeInBytes

Ukuran internal blok objek disk virtual, dalam byte. Ini harus diatur ke salah satu nilai berikut.

Nilai Makna
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 Ini adalah nilai default dan mewakili ukuran blok 2 MB.
524288 (0x80000)
 Ukuran blok adalah 512 KB.
2097152 (0x200000)
 Ukuran blok adalah 2 MB

Version1.SectorSizeInBytes

Ukuran internal sektor objek disk virtual. Harus diatur ke 512.

Nilai Makna
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_SECTOR_SIZE
0x200
 Ukuran default dan hanya yang diperbolehkan, 512 byte.

Version1.ParentPath

Jalur opsional yang sepenuhnya memenuhi syarat ke objek disk virtual induk. Mengaitkan disk virtual baru dengan disk virtual yang ada.

Jika parameter ini bukan NULL, SourcePath harus NULL.

Version1.SourcePath

Jalur opsional yang sepenuhnya memenuhi syarat untuk mengisi objek disk virtual baru dengan data blok dari disk yang ada. Jalur ini dapat merujuk ke disk virtual atau disk fisik.

Jika parameter ini bukan NULL, ParentPath harus NULL.

Version2

Struktur ini digunakan jika anggota VersiCREATE_VIRTUAL_DISK_VERSION_2 (2).

Windows 7 dan Windows Server 2008 R2: Struktur ini tidak didukung hingga Windows 8 dan Windows Server 2012.

Version2.UniqueId

Pengidentifikasi unik untuk ditetapkan ke objek disk virtual. Jika anggota ini diatur ke nol, pengidentifikasi unik dibuat oleh sistem.

Version2.MaximumSize

Ukuran virtual maksimum, dalam byte, dari objek disk virtual. Harus kelipatan 512.

Jika ParentPath ditentukan, nilai ini harus nol.

Jika SourcePath ditentukan, nilai ini bisa nol untuk menentukan ukuran disk virtual sumber yang akan digunakan, jika tidak, ukuran yang ditentukan harus lebih besar dari atau sama dengan ukuran disk sumber.

Version2.BlockSizeInBytes

Ukuran internal blok objek disk virtual, dalam byte. Untuk VHDX ini harus kelipatan 1 MB antara 1 dan 256 MB. Untuk VHD 1, ini harus diatur ke salah satu nilai berikut.

Nilai Makna
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 Ini adalah nilai default dan mewakili ukuran blok 2 MB. Ini adalah satu-satunya nilai yang didukung untuk disk virtual VHD 1 tetap.
524288 (0x80000)
 Ukuran blok adalah 512 KB. Nilai ini tidak didukung pada disk virtual VHD 1 tetap.
2097152 (0x200000)
 Ukuran blok adalah 2 MB. Nilai ini tidak didukung pada disk virtual VHD 1 tetap.

Version2.SectorSizeInBytes

Ukuran internal sektor objek disk virtual. Untuk VHDX harus diatur ke 512 (0x200) atau 4096 (0x1000). Untuk VHD 1 harus diatur ke 512.

Version2.PhysicalSectorSizeInBytes

Version2.ParentPath

Jalur opsional yang sepenuhnya memenuhi syarat ke objek disk virtual induk. Mengaitkan disk virtual baru dengan disk virtual yang ada.

Jika parameter ini bukan NULL, SourcePath harus NULL.

Version2.SourcePath

Jalur opsional yang sepenuhnya memenuhi syarat untuk mengisi objek disk virtual baru dengan data blok dari disk yang ada. Jalur ini dapat merujuk ke disk virtual atau disk fisik.

Jika parameter ini bukan NULL, ParentPath harus NULL.

Version2.OpenFlags

Nol atau lebih bendera dari enumerasi OPEN_VIRTUAL_DISK_FLAG yang menjelaskan bagaimana disk virtual akan dibuka.

Version2.ParentVirtualStorageType

Struktur VIRTUAL_STORAGE_TYPE yang menjelaskan disk virtual induk yang ditentukan dalam anggota ParentPath .

Version2.SourceVirtualStorageType

Struktur VIRTUAL_STORAGE_TYPE yang menjelaskan disk virtual sumber yang ditentukan dalam anggota SourcePath .

Version2.ResiliencyGuid

GUID ketahanan untuk file.

Catatan

Parameter berikut prefaced Version3 dan Version4 ditujukan untuk penggunaan internal.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Server minimum yang didukung Windows Server 2008 R2
Header virtdisk.h

Lihat juga

Tentang VHD

CreateVirtualDisk

Menamai File, Jalur, dan Namespace

Referensi VHD

Struktur VHD

  • Last updated on