структура VDS_STORAGE_POOL_PROP (vdshwprv.h)
[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Определяет свойства объекта пула носителей.
Синтаксис
typedef struct _VDS_STORAGE_POOL_PROP {
VDS_OBJECT_ID id;
VDS_STORAGE_POOL_STATUS status;
VDS_HEALTH health;
VDS_STORAGE_POOL_TYPE type;
LPWSTR pwszName;
LPWSTR pwszDescription;
ULONGLONG ullTotalConsumedSpace;
ULONGLONG ullTotalManagedSpace;
ULONGLONG ullRemainingFreeSpace;
} VDS_STORAGE_POOL_PROP, *PVDS_STORAGE_POOL_PROP;
Члены
id
Значение VDS_OBJECT_ID , определяющее объект пула носителей.
status
Значение перечисления VDS_STORAGE_POOL_STATUS , указывающее состояние пула носителей.
health
Значение перечисления VDS_HEALTH , указывающее работоспособность пула носителей. Ниже приведены допустимые значения для этого элемента.
Windows Server 2008, Windows Vista и Windows Server 2003: VDS_H_DEGRADED не поддерживается.
VDS_H_UNKNOWN (0)
VDS_H_HEALTHY (1)
VDS_H_DEGRADED (11)
type
Значение перечисления VDS_STORAGE_POOL_TYPE , указывающее тип пула носителей.
pwszName
Строка, указывающая имя пула носителей.
pwszDescription
Строка, содержащая описание пула носителей.
ullTotalConsumedSpace
Объем физического хранилища для пула носителей в байтах. Значение этого элемента должно быть меньше или равно значению элемента ullProvisionedSpaceструктуры VDS_POOL_ATTRIBUTES .
ullTotalManagedSpace
Пространство в байтах в этом пуле носителей, которое можно выделить для создания дочерних элементов хранения (LUN или пулов), включая уже выделенное пространство. В зависимости от способа настройки пула носителей значение этого элемента может быть гораздо меньше значения элемента ullTotalConsumedSpace . Например, если пул носителей настроен как зеркальный пул, значение ullTotalManagedSpace будет только вдвое меньше значения элемента ullTotalConsumedSpace .
ullRemainingFreeSpace
Максимальный размер, который можно использовать для создания новых LUN или дочерних пулов носителей из этого пула, а также для расширения существующих LUN или дочерних пулов носителей. Чтобы вычислить объем управляемого пространства, уже выделенного для существующих LUN или дочерних пулов носителей, вычтите значение этого элемента из значения элемента ullTotalManagedSpace .
Комментарии
IVdsStoragePool::GetProperties возвращает эту структуру для отчета о свойствах объекта пула носителей.
В следующих примерах показано, как элементы ullTotalConsumedSpace, ullTotalManagedSpace и ullRemainingFreeSpace работают вместе.
Пример 1
Предположим, у вас есть 2 диска по 1 ТБ каждый. Далее предположим, что вы делаете следующее:- Создайте пул носителей в качестве зеркального пула.
- Создайте LUN размером 200 ГБ.
ullTotalConsumedSpace = 2 ТБ. Это объем пространства пула носителей, который поддерживается физическим хранилищем или физическими дисками. При создании LUN из пула это число не изменяется.
ullTotalManagedSpace = 1 ТБ. Это максимальный размер LUN или пула носителей, который можно создать из этого пула. Доступно только 1 ТБ, так как тип пула является зеркалом только с 2 сплетениями.
ullRemainingFreeSpace = 800 ГБ (1 ТБ – 200 ГБ), так как 200 ГБ уже выделено для LUN.
(ullTotalManagedSpace) - ullRemainingFreeSpace) — это объем управляемого пространства, выделенного для LUN и пулов, созданных из этого пула. В этом примере ullTotalManagedSpace - ullRemainingFreeSpace = 200 ГБ.
Пример 2
Предположим, у вас есть 2 диска по 1 ТБ каждый. Далее предположим, что вы делаете следующее:- Создайте пул носителей в качестве зеркального пула.
- Создайте тонко подготовленный LUN размером 10 ТБ.
ullProvisionedSpace = 10 ТБ. Это относится только к пулам с тонкой подготовкой. Это общее пространство, подготовленное для пула. Общий объем пространства, занятого пулом, меньше или равен общему пространству, подготовленному для пула.
ullTotalConsumedSpace = 2 ТБ.
ullTotalManagedSpace = 1 ТБ.
ullRemainingFreeSpace = 1 ТБ за вычетом объема управляемого пространства, которое в настоящее время поддерживает LUN.
Требования
Минимальная версия клиента | Windows 7 [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
Верхняя часть | vdshwprv.h |