структура GET_VIRTUAL_DISK_INFO (virtdisk.h)
Содержит сведения о виртуальном жестком диске (VHD).
Синтаксис
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;
Члены
Version
Значение перечисления GET_VIRTUAL_DISK_INFO_VERSION , указывающее версию структуры GET_VIRTUAL_DISK_INFO , передаваемой в функции виртуального диска или из нее. Это определяет, какие части этой структуры будут использоваться.
Size
Структура со следующими элементами. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_SIZE.
Size.VirtualSize
Виртуальный размер виртуального диска в байтах.
Size.PhysicalSize
Физический размер виртуального диска на физическом диске в байтах.
Size.BlockSize
Размер блока виртуального диска в байтах.
Size.SectorSize
Размер сектора виртуального диска в байтах.
Identifier
Уникальный идентификатор виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_IDENTIFIER.
ParentLocation
Структура со следующими элементами. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_PARENT_LOCATION.
ParentLocation.ParentResolved
Разрешение родительских элементов. Значение TRUE , если родительское резервное хранилище было успешно разрешено, значение FALSE , если нет.
ParentLocation.ParentLocationBuffer[1]
Если элемент ParentResolved имеет значение TRUE, содержит путь к родительскому резервному хранилищу.
Если элемент ParentResolved имеет значение FALSE, содержит все родительские пути, присутствующие в списке поиска.
ParentIdentifier
Уникальный идентификатор родительского резервного хранилища дисков. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER.
ParentTimestamp
Внутренняя метка времени родительского резервного хранилища дисков. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP.
VirtualStorageType
VIRTUAL_STORAGE_TYPE структуры, содержащей сведения о типе виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE.
ProviderSubtype
Подтип поставщика. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE.
Значение | Значение |
---|---|
|
Фиксированной. |
|
Динамически расширяемый (разреженный). |
|
Разностные. |
Is4kAligned
Указывает, выровнен ли виртуальный диск по 4 КБ. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED.
Windows 7 и Windows Server 2008 R2: Это не поддерживается до Windows 8 и Windows Server 2012.
IsLoaded
Указывает, подключен ли виртуальный диск в данный момент и используется ли он. Значение TRUE , если виртуальный диск подключен и используется в данный момент; в противном случае — FALSE. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_IS_LOADED.
Windows 8 и Windows Server 2012. Это не поддерживается до Windows 8.1 и Windows Server 2012 R2.
PhysicalDisk
Сведения о физическом диске, на котором находится виртуальный диск. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK.
Windows 7 и Windows Server 2008 R2: Это не поддерживается до Windows 8 и Windows Server 2012.
PhysicalDisk.LogicalSectorSize
Размер логического сектора физического диска.
PhysicalDisk.PhysicalSectorSize
Размер физического сектора физического диска.
PhysicalDisk.IsRemote
Указывает, является ли физический диск удаленным.
VhdPhysicalSectorSize
Размер физического сектора виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE.
Windows 7 и Windows Server 2008 R2: Это не поддерживается до Windows 8 и Windows Server 2012.
SmallestSafeVirtualSize
Минимальный безопасный минимальный размер виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE.
Windows 7 и Windows Server 2008 R2: Это не поддерживается до Windows 8 и Windows Server 2012.
FragmentationPercentage
Уровень фрагментации виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_FRAGMENTATION.
Windows 7 и Windows Server 2008 R2: Это не поддерживается до Windows 8 и Windows Server 2012.
VirtualDiskId
Идентификатор, который создается уникально, когда пользователь впервые создает виртуальный диск, чтобы попытаться однозначно идентифицировать этот виртуальный диск. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID.
Windows 8 и Windows Server 2012. Это не поддерживается до Windows 8.1 и Windows Server 2012 R2.
ChangeTrackingState
Состояние устойчивого отслеживания изменений (RCT) для виртуального диска. Задайте для элемента Versionзначение GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE.
Windows 8.1 и Windows Server 2012 R2: этот элемент не поддерживается до Windows 10 и Windows Server 2016.
ChangeTrackingState.Enabled
Указывает, включен ли RCT. Значение TRUE , если RCT включен; в противном случае — FALSE.
ChangeTrackingState.NewerChanges
Изменился ли виртуальный диск с момента изменения, определенного элементом MostRecentId . ЗНАЧЕНИЕ TRUE , если виртуальный диск изменился с момента изменения, определяемого элементом MostRecentId ; в противном случае — FALSE.
ChangeTrackingState.MostRecentId[1]
Идентификатор отслеживания изменений для изменения, определяющий состояние виртуального диска, который вы хотите использовать в качестве основы для сравнения, чтобы определить, сообщает ли член NewerChanges новые изменения.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 7 |
Минимальная версия сервера | Windows Server 2008 R2 |
Верхняя часть | virtdisk.h |