CREATE_VIRTUAL_DISK_PARAMETERS結構 (virtdisk.h)
包含虛擬硬碟 (VHD) 建立參數、提供新建立虛擬磁碟的控制以及相關信息。
語法
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;
成員
Version
來自 CREATE_VIRTUAL_DISK_VERSION 列舉的值，這是等位的辨別。
| 值 | 意義 |
|---|---|
|
使用這個 結構的 Version1 成員。 |
|
使用這個 結構的 Version2 成員。 |
Version1
如果 Version 成員 CREATE_VIRTUAL_DISK_VERSION_1 ( 1) ，則會使用此結構。
Version1.UniqueId
要指派給虛擬磁碟物件的唯一標識符。 如果這個成員設定為零，系統就會建立唯一標識符。
Version1.MaximumSize
虛擬磁碟對象的虛擬大小上限，以位元組為單位。 這必須是 512 的倍數。
如果指定 ParentPath ，這個值必須是零。
如果指定 SourcePath ，這個值可以是零，以指定要使用的來源虛擬磁碟大小，否則指定的大小必須大於或等於來源磁碟的大小。
Version1.BlockSizeInBytes
虛擬磁碟物件區塊的內部大小，以位元組為單位。 這必須設定為下列其中一個值。
| 值 | 意義 |
|---|---|
|
這是預設值，代表 2 MB 的區塊大小。 |
|
區塊大小為 512 KB。 |
|
區塊大小為 2 MB |
Version1.SectorSizeInBytes
虛擬磁碟物件扇區的內部大小。 必須設定為512。
| 值 | 意義 |
|---|---|
|
默認且只允許的大小，512 個字節。 |
Version1.ParentPath
父虛擬磁碟對象的選擇性 完整 路徑。 將新的虛擬磁碟與現有的虛擬磁碟產生關聯。
如果此參數不是 NULL，SourcePath 必須是 NULL。
Version1.SourcePath
選擇性 的完整 路徑，可預先填入新的虛擬磁碟物件，其中包含來自現有磁碟的區塊數據。 此路徑可能參考虛擬磁碟或實體磁碟。
如果此參數不是 NULL，ParentPath 必須是 NULL。
Version2
如果 Version 成員 CREATE_VIRTUAL_DISK_VERSION_2 ( 2) ，則會使用此結構。
Windows 7 和 Windows Server 2008 R2： 在 Windows 8 和 Windows Server 2012 之前，不支援此結構。
Version2.UniqueId
要指派給虛擬磁碟物件的唯一標識符。 如果這個成員設定為零，系統就會建立唯一標識符。
Version2.MaximumSize
虛擬磁碟對象的虛擬大小上限，以位元組為單位。 這必須是 512 的倍數。
如果指定 ParentPath ，這個值必須是零。
如果指定 SourcePath ，這個值可以是零，以指定要使用的來源虛擬磁碟大小，否則指定的大小必須大於或等於來源磁碟的大小。
Version2.BlockSizeInBytes
虛擬磁碟物件區塊的內部大小，以位元組為單位。 針對 VHDX，這必須是介於 1 到 256 MB 之間的 1 MB 倍數。 針對 VHD 1，這必須設定為下列其中一個值。
Version2.SectorSizeInBytes
虛擬磁碟物件扇區的內部大小。 針對 VHDX，必須設定為 512 (0x200) 或 4096 (0x1000) 。 針對 VHD 1，必須設定為 512。
Version2.PhysicalSectorSizeInBytes
Version2.ParentPath
父虛擬磁碟對象的選擇性 完整 路徑。 將新的虛擬磁碟與現有的虛擬磁碟產生關聯。
如果此參數不是 NULL，SourcePath 必須是 NULL。
Version2.SourcePath
選擇性 的完整 路徑，可預先填入新的虛擬磁碟物件，其中包含來自現有磁碟的區塊數據。 此路徑可能參考虛擬磁碟或實體磁碟。
如果此參數不是 NULL，ParentPath 必須是 NULL。
Version2.OpenFlags
OPEN_VIRTUAL_DISK_FLAG 列舉中的 零個或多個旗標，描述虛擬磁碟的開啟方式。
Version2.ParentVirtualStorageType
描述 ParentPath 成員中所指定父虛擬磁碟的VIRTUAL_STORAGE_TYPE結構。
Version2.SourceVirtualStorageType
描述SourcePath成員中所指定來源虛擬磁碟的VIRTUAL_STORAGE_TYPE結構。
Version2.ResiliencyGuid
檔案的復原 GUID 。
注意
下列前置版本 3 和 Version4 的參數適用於內部使用。
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
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 |
| 最低支援的伺服器 | Windows Server 2008 R2 |
| 標頭 | virtdisk.h |