estructura de GET_VIRTUAL_DISK_INFO (virtdisk.h)
Contiene información del disco duro virtual (VHD).
Sintaxis
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;
Miembros
Version
Valor de la enumeración GET_VIRTUAL_DISK_INFO_VERSION que especifica la versión de la estructura GET_VIRTUAL_DISK_INFO que se pasa a o desde las funciones de disco virtual. Esto determina qué partes de esta estructura se usarán.
Size
Estructura con los siguientes miembros. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_SIZE.
Size.VirtualSize
Tamaño virtual del disco virtual, en bytes.
Size.PhysicalSize
Tamaño físico del disco virtual en disco físico, en bytes.
Size.BlockSize
Tamaño de bloque del disco virtual, en bytes.
Size.SectorSize
Tamaño del sector del disco virtual, en bytes.
Identifier
Identificador único del disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_IDENTIFIER.
ParentLocation
Estructura con los siguientes miembros. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_PARENT_LOCATION.
ParentLocation.ParentResolved
Resolución primaria. TRUE si el almacén de respaldo primario se resolvió correctamente, FALSE si no.
ParentLocation.ParentLocationBuffer[1]
Si el miembro ParentResolved es TRUE, contiene la ruta de acceso del almacén de respaldo primario.
Si el miembro ParentResolved es FALSE, contiene todas las rutas de acceso primarias presentes en la lista de búsqueda.
ParentIdentifier
Identificador único del almacén de respaldo del disco primario. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER.
ParentTimestamp
Marca de tiempo interna del almacén de respaldo del disco primario. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP.
VirtualStorageType
VIRTUAL_STORAGE_TYPE estructura que contiene información sobre el tipo de disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE.
ProviderSubtype
Subtipo específico del proveedor. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE.
| Valor | Significado |
|---|---|
|
Fijo. |
|
Expandible dinámicamente (disperso). |
|
Comparación. |
Is4kAligned
Indica si el disco virtual está alineado con 4 KB. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED.
Windows 7 y Windows Server 2008 R2: Esto no se admite antes de Windows 8 y Windows Server 2012.
IsLoaded
Indica si el disco virtual está montado actualmente y en uso. TRUE si el disco virtual está montado actualmente y en uso; en caso contrario , FALSE. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_IS_LOADED.
Windows 8 y Windows Server 2012: no se admite antes de Windows 8.1 y Windows Server 2012 R2.
PhysicalDisk
Detalles sobre el disco físico en el que reside el disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK.
Windows 7 y Windows Server 2008 R2: Esto no se admite antes de Windows 8 y Windows Server 2012.
PhysicalDisk.LogicalSectorSize
Tamaño del sector lógico del disco físico.
PhysicalDisk.PhysicalSectorSize
Tamaño del sector físico del disco físico.
PhysicalDisk.IsRemote
Indica si el disco físico es remoto.
VhdPhysicalSectorSize
Tamaño del sector físico del disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE.
Windows 7 y Windows Server 2008 R2: Esto no se admite antes de Windows 8 y Windows Server 2012.
SmallestSafeVirtualSize
Tamaño mínimo mínimo más pequeño del disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE.
Windows 7 y Windows Server 2008 R2: Esto no se admite antes de Windows 8 y Windows Server 2012.
FragmentationPercentage
Nivel de fragmentación del disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_FRAGMENTATION.
Windows 7 y Windows Server 2008 R2: Esto no se admite antes de Windows 8 y Windows Server 2012.
VirtualDiskId
Identificador que se crea de forma única cuando un usuario crea por primera vez el disco virtual para intentar identificar de forma única ese disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID.
Windows 8 y Windows Server 2012: no se admite antes de Windows 8.1 y Windows Server 2012 R2.
ChangeTrackingState
Estado del seguimiento de cambios resistente (RCT) para el disco virtual. Establezca el miembro Version en GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE.
Windows 8.1 y Windows Server 2012 R2: este miembro no se admite antes de Windows 10 y Windows Server 2016.
ChangeTrackingState.Enabled
Si RCT está activado. TRUE si RCT está activado; en caso contrario , FALSE.
ChangeTrackingState.NewerChanges
Si el disco virtual ha cambiado desde que se produjo el cambio identificado por el miembro MostRecentId . TRUE si el disco virtual ha cambiado desde que se produjo el cambio identificado por el miembro MostRecentId ; en caso contrario , FALSE.
ChangeTrackingState.MostRecentId[1]
Identificador de seguimiento de cambios del cambio que identifica el estado del disco virtual que desea usar como base de comparación para determinar si el miembro NewerChanges notifica nuevos cambios.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Encabezado | virtdisk.h |