struttura CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)
Contiene parametri di creazione del disco rigido virtuale (VHD), fornendo il controllo e le informazioni sul disco virtuale appena creato.
Sintassi
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;
Members
Version
Valore dell'enumerazione CREATE_VIRTUAL_DISK_VERSION che rappresenta la discriminante per l'unione.
Valore | Significato |
---|---|
|
Utilizzare il membro Version1 di questa struttura. |
|
Utilizzare il membro Version2 di questa struttura. |
Version1
Questa struttura viene utilizzata se il membro Version è CREATE_VIRTUAL_DISK_VERSION_1 (1).
Version1.UniqueId
Identificatore univoco da assegnare all'oggetto disco virtuale. Se questo membro è impostato su zero, viene creato un identificatore univoco dal sistema.
Version1.MaximumSize
Dimensione virtuale massima, in byte, dell'oggetto disco virtuale. Questo valore deve essere un multiplo di 512.
Se viene specificato un elemento ParentPath , questo valore deve essere zero.
Se viene specificato sourcePath , questo valore può essere zero per specificare le dimensioni del disco virtuale di origine da utilizzare. In caso contrario, le dimensioni specificate devono essere maggiori o uguali alle dimensioni del disco di origine.
Version1.BlockSizeInBytes
Dimensioni interne dei blocchi di oggetti disco virtuale, in byte. Deve essere impostato su uno dei valori seguenti.
Version1.SectorSizeInBytes
Dimensioni interne dei settori oggetto disco virtuale. Deve essere impostato su 512.
Valore | Significato |
---|---|
|
Dimensioni predefinite e consentite, 512 byte. |
Version1.ParentPath
Percorso completo facoltativo di un oggetto disco virtuale padre. Associa il nuovo disco virtuale a un disco virtuale esistente.
Se questo parametro non è NULL, SourcePath deve essere NULL.
Version1.SourcePath
Percorso completo facoltativo per precompilare il nuovo oggetto disco virtuale con bloccare i dati da un disco esistente. Questo percorso può fare riferimento a un disco virtuale o a un disco fisico.
Se questo parametro non è NULL, ParentPath deve essere NULL.
Version2
Questa struttura viene utilizzata se il membro Version è CREATE_VIRTUAL_DISK_VERSION_2 (2).
Windows 7 e Windows Server 2008 R2: Questa struttura non è supportata fino a Windows 8 e Windows Server 2012.
Version2.UniqueId
Identificatore univoco da assegnare all'oggetto disco virtuale. Se questo membro è impostato su zero, viene creato un identificatore univoco dal sistema.
Version2.MaximumSize
Dimensione virtuale massima, in byte, dell'oggetto disco virtuale. Questo valore deve essere un multiplo di 512.
Se viene specificato un elemento ParentPath , questo valore deve essere zero.
Se viene specificato sourcePath , questo valore può essere zero per specificare le dimensioni del disco virtuale di origine da utilizzare. In caso contrario, le dimensioni specificate devono essere maggiori o uguali alle dimensioni del disco di origine.
Version2.BlockSizeInBytes
Dimensioni interne dei blocchi di oggetti disco virtuale, in byte. Per VHDX questo deve essere un multiplo di 1 MB compreso tra 1 e 256 MB. Per il disco rigido virtuale 1 questo valore deve essere impostato su uno dei valori seguenti.
Version2.SectorSizeInBytes
Dimensioni interne dei settori oggetto disco virtuale. Per VHDX deve essere impostato su 512 (0x200) o 4096 (0x1000). Per il disco rigido virtuale 1 deve essere impostato su 512.
Version2.PhysicalSectorSizeInBytes
Version2.ParentPath
Percorso completo facoltativo di un oggetto disco virtuale padre. Associa il nuovo disco virtuale a un disco virtuale esistente.
Se questo parametro non è NULL, SourcePath deve essere NULL.
Version2.SourcePath
Percorso completo facoltativo per precompilare il nuovo oggetto disco virtuale con bloccare i dati da un disco esistente. Questo percorso può fare riferimento a un disco virtuale o a un disco fisico.
Se questo parametro non è NULL, ParentPath deve essere NULL.
Version2.OpenFlags
Zero o più flag dell'enumerazione OPEN_VIRTUAL_DISK_FLAG che descrive come aprire il disco virtuale.
Version2.ParentVirtualStorageType
Struttura VIRTUAL_STORAGE_TYPE che descrive il disco virtuale padre specificato nel membro ParentPath .
Version2.SourceVirtualStorageType
Struttura VIRTUAL_STORAGE_TYPE che descrive il disco virtuale di origine specificato nel membro SourcePath .
Version2.ResiliencyGuid
GUID di resilienza per il file.
Nota
I parametri seguenti preceduti da Version3 e Version4 sono destinati all'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
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 7 |
Server minimo supportato | Windows Server 2008 R2 |
Intestazione | virtdisk.h |
Vedi anche
Informazioni sul disco rigido virtuale
Denominazione di file, percorsi e spazi dei nomi