структура VDS_POOL_ATTRIBUTES (vdshwprv.h)

Статья
03/08/2023

[Начиная с 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 0x200000L	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