структура VDS_POOL_ATTRIBUTES (vdshwprv.h)
[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Определяет атрибуты пула носителей.
Синтаксис
typedef struct _VDS_POOL_ATTRIBUTES {
ULONGLONG ullAttributeMask;
VDS_RAID_TYPE raidType;
VDS_STORAGE_BUS_TYPE busType;
LPWSTR pwszIntendedUsage;
BOOL bSpinDown;
BOOL bIsThinProvisioned;
ULONGLONG ullProvisionedSpace;
BOOL bNoSinglePointOfFailure;
ULONG ulDataRedundancyMax;
ULONG ulDataRedundancyMin;
ULONG ulDataRedundancyDefault;
ULONG ulPackageRedundancyMax;
ULONG ulPackageRedundancyMin;
ULONG ulPackageRedundancyDefault;
ULONG ulStripeSize;
ULONG ulStripeSizeMax;
ULONG ulStripeSizeMin;
ULONG ulDefaultStripeSize;
ULONG ulNumberOfColumns;
ULONG ulNumberOfColumnsMax;
ULONG ulNumberOfColumnsMin;
ULONG ulDefaultNumberofColumns;
ULONG ulDataAvailabilityHint;
ULONG ulAccessRandomnessHint;
ULONG ulAccessDirectionHint;
ULONG ulAccessSizeHint;
ULONG ulAccessLatencyHint;
ULONG ulAccessBandwidthWeightHint;
ULONG ulStorageCostHint;
ULONG ulStorageEfficiencyHint;
ULONG ulNumOfCustomAttributes;
VDS_POOL_CUSTOM_ATTRIBUTES *pPoolCustomAttributes;
BOOL bReserved1;
BOOL bReserved2;
ULONG ulReserved1;
ULONG ulReserved2;
ULONGLONG ullReserved1;
ULONGLONG ullReserved2;
} VDS_POOL_ATTRIBUTES, *PVDS_POOL_ATTRIBUTES;
Члены
ullAttributeMask
Маска, указывающая атрибуты в структуре, определенные этим пулом носителей.
Ниже приведен список допустимых флагов атрибутов. Каждый флаг соответствует элементу в структуре VDS_POOL_ATTRIBUTES . Неиспользуемые биты зарезервированы.
raidType
Значение перечисления VDS_RAID_TYPE , указывающее тип RAID пула носителей. Если пул носителей не имеет определенного типа RAID, задайте для этого элемента значение VDS_RT_UNKNOWN и снимите флаг атрибута VDS_POOL_ATTRIB_RAIDTYPE в элементе ullAttributeMask .
busType
Значение перечисления VDS_STORAGE_BUS_TYPE , указывающее тип шины дисков в пуле носителей.
pwszIntendedUsage
Строка, указывающая использование пула носителей. Как правило, это может указывать на приложение, использующее пул носителей (например, "SQL" или "Exchange"), или бизнес-функцию, которая использует пул носителей (например, "Финансы" или "Кадровые ресурсы").
bSpinDown
Значение TRUE , если диски в пуле носителей автоматически отключаются для снижения энергопотребления, или false в противном случае.
bIsThinProvisioned
Значение TRUE , если пул носителей является тонко подготовленным, или false в противном случае. Если пул подготовлен тонко, количество байтов в потребляемом пространстве пула может быть меньше числа байтов в подготовленном пространстве пула. (Количество байтов в подготовленном пространстве хранится в элементе ullProvisionedSpace этой структуры. Количество байтов в потребляемом пространстве хранится в элементе ullTotalConsumedSpaceструктуры VDS_STORAGE_POOL_PROP .) Если поставщик оборудования задает этому элементу значение TRUE, он также должен задать для элемента типаструктуры VDS_STORAGE_POOL_PROPзначение VDS_SPT_CONCRETE.
ullProvisionedSpace
Если пул подготовлен тонко, этот член указывает пространство в байтах, подготовленное для пула. Значение этого элемента должно быть больше или равно значению элемента ullTotalConsumedSpace структуры VDS_STORAGE_POOL_PROP .
bNoSinglePointOfFailure
Значение TRUE , если в пуле нет единой точки сбоя, или false в противном случае.
ulDataRedundancyMax
Максимальное количество полных копий данных, которые могут храниться в этом пуле носителей.
ulDataRedundancyMin
Минимальное количество полных копий данных, которые могут храниться в этом пуле носителей.
ulDataRedundancyDefault
Количество полных копий данных, которые хранятся в этом пуле носителей по умолчанию.
ulPackageRedundancyMax
Максимальное количество дисков, которые можно использовать в пуле носителей для обеспечения избыточности пакетов. Избыточность пакета указывает количество дисков, которые могут завершиться сбоем в пуле носителей, не приводя к потере данных.
ulPackageRedundancyMin
Минимальное количество дисков, которые можно использовать в пуле носителей для обеспечения избыточности пакетов. Избыточность пакета указывает количество дисков, которые могут завершиться сбоем в пуле носителей, не приводя к потере данных.
ulPackageRedundancyDefault
Число дисков по умолчанию, используемых в пуле носителей для обеспечения избыточности пакетов. Избыточность пакета указывает количество дисков, которые могут завершиться сбоем в пуле носителей, не приводя к потере данных.
ulStripeSize
Зеркало или размер чередования (в байтах) пула носителей, если пул чередуется (с четностью или без нее).
ulStripeSizeMax
Максимальный размер чередования (в байтах), поддерживаемый пулом носителей.
ulStripeSizeMin
Минимальный размер чередования (в байтах), поддерживаемый пулом носителей.
ulDefaultStripeSize
Размер чередования по умолчанию (в байтах), поддерживаемый пулом носителей.
ulNumberOfColumns
Количество столбцов пула носителей, если пул чередуется (с четностью или без нее).
ulNumberOfColumnsMax
Максимальное количество столбцов, поддерживаемых пулом носителей.
ulNumberOfColumnsMin
Минимальное количество столбцов, поддерживаемых пулом носителей.
ulDefaultNumberofColumns
Число столбцов по умолчанию, поддерживаемых пулом носителей.
ulDataAvailabilityHint
Указание от клиента, указывающее важность доступности данных. Значения варьируются от 0 (не важно) до 10 (очень важно).
ulAccessRandomnessHint
Указание от клиента, указывающее на случайный доступ к данным. Значения варьируются от 0 (полностью последовательный) до 10 (совершенно случайный).
ulAccessDirectionHint
Указание от клиента, указывающее направление доступа к данным. Значения варьируются от 0 (полностью чтение) до 10 (полностью запись).
ulAccessSizeHint
Указание от клиента, указывающее оптимальный размер доступа в мегабайтах.
ulAccessLatencyHint
Подсказка от клиента, указывающая важность задержки доступа для клиента. Значения варьируются от 0 (не важно) до 10 (очень важно).
ulAccessBandwidthWeightHint
Указание от клиента, указывающее на важность высокой пропускной способности. Значения варьируются от 0 (не важно) до 10 (очень важно).
ulStorageCostHint
Указание от клиента, указывающее на важность стоимости хранилища для клиента. Значения варьируются от 0 (не важно) до 10 (очень важно). Если стоимость хранилища очень важна для клиента, значение 10 указывает на то, что клиент предпочел бы подготовить пул с использованием хранилища с меньшими затратами.
ulStorageEfficiencyHint
Указание от клиента, указывающее на важность эффективности хранилища для клиента. Значения варьируются от 0 (не важно) до 10 (очень важно).
ulNumOfCustomAttributes
Количество настраиваемых атрибутов, определенных для пула носителей.
pPoolCustomAttributes
Массив структур VDS_POOL_CUSTOM_ATTRIBUTES . Каждая структура содержит настраиваемый атрибут, определенный для пула носителей.
bReserved1
Этот элемент зарезервирован для использования в будущем. Не используйте.
bReserved2
Этот элемент зарезервирован для использования в будущем. Не используйте.
ulReserved1
Этот элемент зарезервирован для использования в будущем. Не используйте.
ulReserved2
Этот элемент зарезервирован для использования в будущем. Не используйте.
ullReserved1
Этот элемент зарезервирован для использования в будущем. Не используйте.
ullReserved2
Этот элемент зарезервирован для использования в будущем. Не используйте.
Комментарии
Если атрибут задан для пула носителей, этот параметр атрибута должен применяться ко всем экстентам дисков, составляющим пул.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Верхняя часть | vdshwprv.h |