struttura CREATE_VIRTUAL_DISK_PARAMETERS (virtdisk.h)

Articolo
03/13/2024

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
CREATE_VIRTUAL_DISK_VERSION_1 1	Utilizzare il membro Version1 di questa struttura.
CREATE_VIRTUAL_DISK_VERSION_2 2	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.

Valore	Significato
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE 0	Si tratta del valore predefinito e rappresenta una dimensione del blocco di 2 MB.
524288 (0x80000)	La dimensione del blocco è 512 KB.
2097152 (0x200000)	La dimensione del blocco è 2 MB

Version1.SectorSizeInBytes

Dimensioni interne dei settori oggetto disco virtuale. Deve essere impostato su 512.

Valore	Significato
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_SECTOR_SIZE 0x200	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.

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.

Valore	Significato
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE 0	Si tratta del valore predefinito e rappresenta una dimensione del blocco di 2 MB. Si tratta dell'unico valore supportato per dischi virtuali VHD 1 fissi.
524288 (0x80000)	La dimensione del blocco è 512 KB. Questo valore non è supportato nei dischi virtuali VHD 1 fissi.
2097152 (0x200000)	La dimensione del blocco è 2 MB. Questo valore non è supportato nei dischi virtuali VHD 1 fissi.

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

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

CreateVirtualDisk

Denominazione di file, percorsi e spazi dei nomi

Informazioni di riferimento sul disco rigido virtuale

Strutture VHD

Condividi tramite