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
가상 디스크 개체에 할당할 고유 식별자입니다. 이 멤버가 0으로 설정된 경우 시스템에서 고유 식별자를 만듭니다.
Version1.MaximumSize
가상 디스크 개체의 최대 가상 크기(바이트)입니다. 512의 배수여야 합니다.
ParentPath를 지정하는 경우 이 값은 0이어야 합니다.
SourcePath를 지정한 경우 이 값은 사용할 원본 가상 디스크의 크기를 지정하는 데 0일 수 있으며, 그렇지 않으면 지정된 크기가 원본 디스크의 크기보다 크거나 같아야 합니다.
Version1.BlockSizeInBytes
가상 디스크 개체 블록의 내부 크기(바이트)입니다. 다음 값 중 하나로 설정해야 합니다.
| 값 | 의미 |
|---|---|
|
이 값은 기본값이며 블록 크기가 2MB임을 나타냅니다. |
|
블록 크기는 512KB입니다. |
|
블록 크기는 2MB입니다. |
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
가상 디스크 개체에 할당할 고유 식별자입니다. 이 멤버가 0으로 설정된 경우 시스템에서 고유 식별자를 만듭니다.
Version2.MaximumSize
가상 디스크 개체의 최대 가상 크기(바이트)입니다. 512의 배수여야 합니다.
ParentPath를 지정하는 경우 이 값은 0이어야 합니다.
SourcePath를 지정한 경우 이 값은 사용할 원본 가상 디스크의 크기를 지정하는 데 0일 수 있으며, 그렇지 않으면 지정된 크기가 원본 디스크의 크기보다 크거나 같아야 합니다.
Version2.BlockSizeInBytes
가상 디스크 개체 블록의 내부 크기(바이트)입니다. VHDX의 경우 1MB에서 256MB 사이의 배수여야 합니다. 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 열거형의 플래그가 0개 이상입니다.
Version2.ParentVirtualStorageType
ParentPath 멤버에 지정된 부모 가상 디스크를 설명하는 VIRTUAL_STORAGE_TYPE 구조체입니다.
Version2.SourceVirtualStorageType
SourcePath 멤버에 지정된 원본 가상 디스크를 설명하는 VIRTUAL_STORAGE_TYPE 구조체입니다.
Version2.ResiliencyGuid
파일에 대한 복원력 GUID 입니다.
참고
Version3 및 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 |