estrutura GET_VIRTUAL_DISK_INFO (virtdisk.h)
Contém informações de VHD (disco rígido virtual).
Sintaxe
typedef struct _GET_VIRTUAL_DISK_INFO {
GET_VIRTUAL_DISK_INFO_VERSION Version;
union {
struct {
ULONGLONG VirtualSize;
ULONGLONG PhysicalSize;
ULONG BlockSize;
ULONG SectorSize;
} Size;
GUID Identifier;
struct {
BOOL ParentResolved;
WCHAR ParentLocationBuffer[1];
} ParentLocation;
GUID ParentIdentifier;
ULONG ParentTimestamp;
VIRTUAL_STORAGE_TYPE VirtualStorageType;
ULONG ProviderSubtype;
BOOL Is4kAligned;
BOOL IsLoaded;
struct {
ULONG LogicalSectorSize;
ULONG PhysicalSectorSize;
BOOL IsRemote;
} PhysicalDisk;
ULONG VhdPhysicalSectorSize;
ULONGLONG SmallestSafeVirtualSize;
ULONG FragmentationPercentage;
GUID VirtualDiskId;
struct {
BOOL Enabled;
BOOL NewerChanges;
WCHAR MostRecentId[1];
} ChangeTrackingState;
};
} GET_VIRTUAL_DISK_INFO, *PGET_VIRTUAL_DISK_INFO;
Membros
Version
Um valor da enumeração GET_VIRTUAL_DISK_INFO_VERSION que especifica a versão da estrutura de GET_VIRTUAL_DISK_INFO que está sendo passada para ou das funções de disco virtual. Isso determina quais partes dessa estrutura serão usadas.
Size
Uma estrutura com os membros a seguir. Defina o membro Version como GET_VIRTUAL_DISK_INFO_SIZE.
Size.VirtualSize
Tamanho virtual do disco virtual, em bytes.
Size.PhysicalSize
Tamanho físico do disco virtual no disco físico, em bytes.
Size.BlockSize
Tamanho do bloco do disco virtual, em bytes.
Size.SectorSize
Tamanho do setor do disco virtual, em bytes.
Identifier
Identificador exclusivo do disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_IDENTIFIER.
ParentLocation
Uma estrutura com os membros a seguir. Defina o membro Version como GET_VIRTUAL_DISK_INFO_PARENT_LOCATION.
ParentLocation.ParentResolved
Resolução pai. TRUE se o repositório de backup pai tiver sido resolvido com êxito, FALSE se não for.
ParentLocation.ParentLocationBuffer[1]
Se o membro ParentResolved for TRUE, conterá o caminho do repositório de backup pai.
Se o membro ParentResolved for FALSE, conterá todos os caminhos pai presentes na lista de pesquisa.
ParentIdentifier
Identificador exclusivo do repositório de backup de disco pai. Defina o membro Version como GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER.
ParentTimestamp
Carimbo de data/hora interno do repositório de backup de disco pai. Defina o membro Version como GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP.
VirtualStorageType
VIRTUAL_STORAGE_TYPE estrutura que contém informações sobre o tipo de disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE.
ProviderSubtype
Subtipo específico do provedor. Defina o membro Version como GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE.
| Valor | Significado |
|---|---|
|
Fixo. |
|
Expansível dinamicamente (esparso). |
|
Diferencial. |
Is4kAligned
Indica se o disco virtual está alinhado a 4 KB. Defina o membro Version como GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED.
Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.
IsLoaded
Indica se o disco virtual está montado e em uso no momento. TRUE se o disco virtual estiver montado no momento e em uso; caso contrário , FALSE. Defina o membro Version como GET_VIRTUAL_DISK_INFO_IS_LOADED.
Windows 8 e Windows Server 2012: não há suporte para isso antes do Windows 8.1 e do Windows Server 2012 R2.
PhysicalDisk
Detalhes sobre o disco físico no qual o disco virtual reside. Defina o membro Version como GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK.
Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.
PhysicalDisk.LogicalSectorSize
O tamanho do setor lógico do disco físico.
PhysicalDisk.PhysicalSectorSize
O tamanho do setor físico do disco físico.
PhysicalDisk.IsRemote
Indica se o disco físico é remoto.
VhdPhysicalSectorSize
O tamanho do setor físico do disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE.
Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.
SmallestSafeVirtualSize
O menor tamanho mínimo seguro do disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE.
Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.
FragmentationPercentage
O nível de fragmentação do disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_FRAGMENTATION.
Windows 7 e Windows Server 2008 R2: Não há suporte para isso antes de Windows 8 e Windows Server 2012.
VirtualDiskId
O identificador que é criado exclusivamente quando um usuário cria o disco virtual pela primeira vez para tentar identificar exclusivamente esse disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID.
Windows 8 e Windows Server 2012: não há suporte para isso antes do Windows 8.1 e do Windows Server 2012 R2.
ChangeTrackingState
O estado do RCT (controle de alterações resiliente) para o disco virtual. Defina o membro Version como GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE.
Windows 8.1 e Windows Server 2012 R2: esse membro não tem suporte antes de Windows 10 e Windows Server 2016.
ChangeTrackingState.Enabled
Se a RCT está ativada. TRUE se a RCT estiver ativada; caso contrário , FALSE.
ChangeTrackingState.NewerChanges
Se o disco virtual foi alterado desde que a alteração identificada pelo membro MostRecentId ocorreu. TRUE se o disco virtual foi alterado desde que a alteração identificada pelo membro MostRecentId ocorreu; caso contrário , FALSE.
ChangeTrackingState.MostRecentId[1]
O identificador de controle de alterações para a alteração que identifica o estado do disco virtual que você deseja usar como base de comparação para determinar se o membro NewerChanges relata novas alterações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 |
| Servidor mínimo com suporte | Windows Server 2008 R2 |
| Cabeçalho | virtdisk.h |