estrutura CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)
Contém parâmetros de criação de VHD (disco rígido virtual), fornecendo controle sobre e informações sobre o disco virtual recém-criado.
Sintaxe
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;
Membros
Version
Um valor da enumeração CREATE_VIRTUAL_DISK_VERSION que é o discriminante para a união.
| Valor | Significado |
|---|---|
|
Use o membro Version1 dessa estrutura. |
|
Use o membro Version2 dessa estrutura. |
Version1
Essa estrutura será usada se o membro Version for CREATE_VIRTUAL_DISK_VERSION_1 (1).
Version1.UniqueId
Identificador exclusivo a ser atribuído ao objeto de disco virtual. Se esse membro for definido como zero, um identificador exclusivo será criado pelo sistema.
Version1.MaximumSize
O tamanho virtual máximo, em bytes, do objeto de disco virtual. Ele deve ser um múltiplo de 512.
Se um ParentPath for especificado, esse valor deverá ser zero.
Se um SourcePath for especificado, esse valor poderá ser zero para especificar o tamanho do disco virtual de origem a ser usado, caso contrário, o tamanho especificado deverá ser maior ou igual ao tamanho do disco de origem.
Version1.BlockSizeInBytes
Tamanho interno dos blocos de objeto de disco virtual, em bytes. Isso deve ser definido como um dos valores a seguir.
Version1.SectorSizeInBytes
Tamanho interno dos setores de objetos de disco virtual. Deve ser definido como 512.
| Valor | Significado |
|---|---|
|
O tamanho padrão e somente permitido, 512 bytes. |
Version1.ParentPath
Caminho totalmente qualificado opcional para um objeto de disco virtual pai. Associa o novo disco virtual a um disco virtual existente.
Se esse parâmetro não for NULL, SourcePath deverá ser NULL.
Version1.SourcePath
Caminho totalmente qualificado opcional para preencher previamente o novo objeto de disco virtual com dados de bloco de um disco existente. Esse caminho pode se referir a um disco virtual ou a um disco físico.
Se esse parâmetro não for NULL, ParentPath deverá ser NULL.
Version2
Essa estrutura será usada se o membro Version for CREATE_VIRTUAL_DISK_VERSION_2 (2).
Windows 7 e Windows Server 2008 R2: Essa estrutura não tem suporte até Windows 8 e Windows Server 2012.
Version2.UniqueId
Identificador exclusivo a ser atribuído ao objeto de disco virtual. Se esse membro for definido como zero, um identificador exclusivo será criado pelo sistema.
Version2.MaximumSize
O tamanho virtual máximo, em bytes, do objeto de disco virtual. Ele deve ser um múltiplo de 512.
Se um ParentPath for especificado, esse valor deverá ser zero.
Se um SourcePath for especificado, esse valor poderá ser zero para especificar o tamanho do disco virtual de origem a ser usado, caso contrário, o tamanho especificado deverá ser maior ou igual ao tamanho do disco de origem.
Version2.BlockSizeInBytes
Tamanho interno dos blocos de objeto de disco virtual, em bytes. Para VHDX, esse deve ser um múltiplo de 1 MB entre 1 e 256 MB. Para o VHD 1, isso deve ser definido como um dos valores a seguir.
Version2.SectorSizeInBytes
Tamanho interno dos setores de objetos de disco virtual. Para O VHDX deve ser definido como 512 (0x200) ou 4096 (0x1000). Para O VHD 1 deve ser definido como 512.
Version2.PhysicalSectorSizeInBytes
Version2.ParentPath
Caminho totalmente qualificado opcional para um objeto de disco virtual pai. Associa o novo disco virtual a um disco virtual existente.
Se esse parâmetro não for NULL, SourcePath deverá ser NULL.
Version2.SourcePath
Caminho totalmente qualificado opcional para preencher previamente o novo objeto de disco virtual com dados de bloco de um disco existente. Esse caminho pode se referir a um disco virtual ou a um disco físico.
Se esse parâmetro não for NULL, ParentPath deverá ser NULL.
Version2.OpenFlags
Zero ou mais sinalizadores da enumeração OPEN_VIRTUAL_DISK_FLAG que descreve como o disco virtual deve ser aberto.
Version2.ParentVirtualStorageType
Uma estrutura VIRTUAL_STORAGE_TYPE que descreve o disco virtual pai especificado no membro ParentPath .
Version2.SourceVirtualStorageType
Uma estrutura VIRTUAL_STORAGE_TYPE que descreve o disco virtual de origem especificado no membro SourcePath .
Version2.ResiliencyGuid
GUID de resiliência para o arquivo.
Observação
Os parâmetros a seguir precedidos de Version3 e Version4 destinam-se ao uso interno.
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
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Cabeçalho | virtdisk.h |