estructura de CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)
Contiene parámetros de creación de disco duro virtual (VHD), lo que proporciona control sobre el disco virtual recién creado e información sobre él.
Sintaxis
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;
Miembros
Version
Valor de la enumeración CREATE_VIRTUAL_DISK_VERSION que es el discriminante para la unión.
| Valor | Significado |
|---|---|
|
Use el miembro Version1 de esta estructura. |
|
Use el miembro Version2 de esta estructura. |
Version1
Esta estructura se usa si el miembro Version es CREATE_VIRTUAL_DISK_VERSION_1 (1).
Version1.UniqueId
Identificador único que se va a asignar al objeto de disco virtual. Si este miembro se establece en cero, el sistema crea un identificador único.
Version1.MaximumSize
Tamaño virtual máximo, en bytes, del objeto de disco virtual. Debe ser un múltiplo de 512.
Si se especifica parentPath , este valor debe ser cero.
Si se especifica sourcePath , este valor puede ser cero para especificar el tamaño del disco virtual de origen que se va a usar; de lo contrario, el tamaño especificado debe ser mayor o igual que el tamaño del disco de origen.
Version1.BlockSizeInBytes
Tamaño interno de los bloques de objetos de disco virtual, en bytes. Debe establecerse en uno de los valores siguientes.
Version1.SectorSizeInBytes
Tamaño interno de los sectores de objetos de disco virtual. Debe establecerse en 512.
| Valor | Significado |
|---|---|
|
Tamaño predeterminado y solo permitido, 512 bytes. |
Version1.ParentPath
Ruta de acceso completa opcional a un objeto de disco virtual primario. Asocia el nuevo disco virtual a un disco virtual existente.
Si este parámetro no es NULL, SourcePath debe ser NULL.
Version1.SourcePath
Ruta de acceso completa opcional para rellenar previamente el nuevo objeto de disco virtual con datos de bloque de un disco existente. Esta ruta de acceso puede hacer referencia a un disco virtual o a un disco físico.
Si este parámetro no es NULL, ParentPath debe ser NULL.
Version2
Esta estructura se usa si el miembro Version es CREATE_VIRTUAL_DISK_VERSION_2 (2).
Windows 7 y Windows Server 2008 R2: Esta estructura no se admite hasta Windows 8 y Windows Server 2012.
Version2.UniqueId
Identificador único que se va a asignar al objeto de disco virtual. Si este miembro se establece en cero, el sistema crea un identificador único.
Version2.MaximumSize
Tamaño virtual máximo, en bytes, del objeto de disco virtual. Debe ser un múltiplo de 512.
Si se especifica parentPath , este valor debe ser cero.
Si se especifica sourcePath , este valor puede ser cero para especificar el tamaño del disco virtual de origen que se va a usar; de lo contrario, el tamaño especificado debe ser mayor o igual que el tamaño del disco de origen.
Version2.BlockSizeInBytes
Tamaño interno de los bloques de objetos de disco virtual, en bytes. Para VHDX, debe ser un múltiplo de 1 MB entre 1 y 256 MB. Para VHD 1, debe establecerse en uno de los valores siguientes.
Version2.SectorSizeInBytes
Tamaño interno de los sectores de objetos de disco virtual. Para VHDX debe establecerse en 512 (0x200) o 4096 (0x1000). Para VHD 1 debe establecerse en 512.
Version2.PhysicalSectorSizeInBytes
Version2.ParentPath
Ruta de acceso completa opcional a un objeto de disco virtual primario. Asocia el nuevo disco virtual a un disco virtual existente.
Si este parámetro no es NULL, SourcePath debe ser NULL.
Version2.SourcePath
Ruta de acceso completa opcional para rellenar previamente el nuevo objeto de disco virtual con datos de bloque de un disco existente. Esta ruta de acceso puede hacer referencia a un disco virtual o a un disco físico.
Si este parámetro no es NULL, ParentPath debe ser NULL.
Version2.OpenFlags
Cero o más marcas de la enumeración OPEN_VIRTUAL_DISK_FLAG que describe cómo se va a abrir el disco virtual.
Version2.ParentVirtualStorageType
Estructura VIRTUAL_STORAGE_TYPE que describe el disco virtual primario especificado en el miembro ParentPath .
Version2.SourceVirtualStorageType
Estructura VIRTUAL_STORAGE_TYPE que describe el disco virtual de origen especificado en el miembro SourcePath .
Version2.ResiliencyGuid
GUID de resistencia para el archivo.
Nota
Los parámetros siguientes precedidos de Version3 y Version4 están diseñados para 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Encabezado | virtdisk.h |
Consulte también
Asignar nombres a archivos, rutas de acceso y espacios de nombres