Поделиться через


структура VDS_POOL_ATTRIBUTES (vds.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 . Неиспользуемые биты зарезервированы.

Значение Атрибут, определенный пулом носителей
VDS_POOL_ATTRIB_RAIDTYPE
0x1L
raidType
VDS_POOL_ATTRIB_BUSTYPE
0x2L
busType
VDS_POOL_ATTRIB_ALLOW_SPINDOWN
0x4L
bSpinDown
VDS_POOL_ATTRIB_THIN_PROVISION
0x8L
bIsThinProvisioned
VDS_POOL_ATTRIB_NO_SINGLE_POF
0x10L
bNoSinglePointOfFailure
VDS_POOL_ATTRIB_DATA_RDNCY_MAX
0x20L
ulDataRedundancyMax
VDS_POOL_ATTRIB_DATA_RDNCY_MIN
0x40L
ulDataRedundancyMin
VDS_POOL_ATTRIB_DATA_RDNCY_DEF
0x80L
ulDataRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MAX
0x100L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MIN
0x200L
ulPackageRedundancyMin
VDS_POOL_ATTRIB_PKG_RDNCY_DEF
0x400L
ulPackageRedundancyDefault
VDS_POOL_ATTRIB_STRIPE_SIZE
0x800L
ulStripeSize
VDS_POOL_ATTRIB_STRIPE_SIZE_MAX
0x1000L
ulStripeSizeMax
VDS_POOL_ATTRIB_STRIPE_SIZE_MIN
0x2000L
ulStripeSizeMin
VDS_POOL_ATTRIB_STRIPE_SIZE_DEF
0x4000L
ulDefaultStripeSize
VDS_POOL_ATTRIB_NUM_CLMNS
0x8000L
ulNumberOfColumns
VDS_POOL_ATTRIB_NUM_CLMNS_MAX
0x10000L
ulNumberOfColumnsMax
VDS_POOL_ATTRIB_NUM_CLMNS_MIN
0x20000L
ulNumberOfColumnsMin
VDS_POOL_ATTRIB_NUM_CLMNS_DEF
0x40000L
ulDefaultNumberofColumns
VDS_POOL_ATTRIB_DATA_AVL_HINT
0x80000L
ulDataAvailabilityHint
VDS_POOL_ATTRIB_ACCS_RNDM_HINT
0x100000L
ulAccessRandomnessHint
VDS_POOL_ATTRIB_ACCS_DIR_HINT
0x200000L
ulAccessDirectionHint
VDS_POOL_ATTRIB_ACCS_SIZE_HINT
0x400000L
ulAccessSizeHint
VDS_POOL_ATTRIB_ACCS_LTNCY_HINT
0x800000L
ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT
0x1000000L
ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT
0x2000000L
ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT
0x4000000L
ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x8000000L
pPoolCustomAttributes

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 [только классические приложения]
Верхняя часть vds.h

См. также раздел

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes