Compartilhar via


estrutura VDS_POOL_ATTRIBUTES (vdshwprv.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define os atributos de um pool de armazenamento.

Sintaxe

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;

Membros

ullAttributeMask

Uma máscara que especifica os atributos na estrutura definida por esse pool de armazenamento.

A lista de sinalizadores de atributo válidos é a seguinte. Cada sinalizador corresponde a um membro na estrutura VDS_POOL_ATTRIBUTES . Os bits não utilizados são reservados.

Valor Atributo definido pelo pool de armazenamento
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

Um VDS_RAID_TYPE valor de enumeração que especifica o tipo RAID do pool de armazenamento. Se o pool de armazenamento não tiver um tipo RAID específico, defina esse membro como VDS_RT_UNKNOWN e desmarque o sinalizador de atributo VDS_POOL_ATTRIB_RAIDTYPE no membro ullAttributeMask .

busType

Um VDS_STORAGE_BUS_TYPE valor de enumeração que especifica o tipo de barramento das unidades no pool de armazenamento.

pwszIntendedUsage

Uma cadeia de caracteres que especifica o uso do pool de armazenamento. Normalmente, isso pode indicar o aplicativo que está usando o pool de armazenamento (por exemplo, "SQL" ou "Exchange") ou a função de negócios que está usando o pool de armazenamento (por exemplo, "Finanças" ou "Recursos Humanos").

bSpinDown

TRUE se as unidades no pool de armazenamento girarem automaticamente para reduzir o uso de energia ou FALSE caso contrário.

bIsThinProvisioned

TRUE se o pool de armazenamento for provisionado de forma fina ou FALSE caso contrário. Se o pool for provisionado, o número de bytes no espaço consumido do pool poderá ser menor que o número de bytes no espaço provisionado do pool. (O número de bytes no espaço provisionado é armazenado no membro ullProvisionedSpace dessa estrutura. O número de bytes no espaço consumido é armazenado no membro ullTotalConsumedSpace da estrutura VDS_STORAGE_POOL_PROP .) Quando um provedor de hardware define esse membro como TRUE, ele também deve definir o membro de tipo da estrutura VDS_STORAGE_POOL_PROP como VDS_SPT_CONCRETE.

ullProvisionedSpace

Se o pool for provisionado, esse membro especificará o espaço, em bytes, provisionado para o pool. O valor desse membro deve ser maior ou igual ao valor do membro ullTotalConsumedSpace da estrutura VDS_STORAGE_POOL_PROP .

bNoSinglePointOfFailure

TRUE se não houver nenhum ponto único de falha no pool ou FALSE caso contrário.

ulDataRedundancyMax

O número máximo de cópias completas dos dados que podem ser mantidos neste pool de armazenamento.

ulDataRedundancyMin

O número mínimo de cópias completas dos dados que podem ser mantidos nesse pool de armazenamento.

ulDataRedundancyDefault

O número padrão de cópias completas dos dados mantidos neste pool de armazenamento.

ulPackageRedundancyMax

O número máximo de unidades que podem ser usadas no pool de armazenamento para garantir a redundância do pacote. A redundância de pacote indica o número de unidades que podem falhar no pool de armazenamento sem resultar em uma perda de dados.

ulPackageRedundancyMin

O número mínimo de unidades que podem ser usadas no pool de armazenamento para garantir a redundância do pacote. A redundância de pacote indica o número de unidades que podem falhar no pool de armazenamento sem resultar em uma perda de dados.

ulPackageRedundancyDefault

O número padrão de unidades usadas no pool de armazenamento para garantir a redundância do pacote. A redundância de pacote indica o número de unidades que podem falhar no pool de armazenamento sem resultar em uma perda de dados.

ulStripeSize

O espelho ou tamanho de distribuição de paridade, em bytes, do pool de armazenamento se o pool estiver distribuído (com ou sem paridade).

ulStripeSizeMax

O tamanho máximo de distribuição, em bytes, que é compatível com o pool de armazenamento.

ulStripeSizeMin

O tamanho mínimo de distribuição, em bytes, que é compatível com o pool de armazenamento.

ulDefaultStripeSize

O tamanho de distribuição padrão, em bytes, que é compatível com o pool de armazenamento.

ulNumberOfColumns

O número de colunas do pool de armazenamento se o pool for distribuído (com ou sem paridade).

ulNumberOfColumnsMax

O número máximo de colunas compatíveis com o pool de armazenamento.

ulNumberOfColumnsMin

O número mínimo de colunas compatíveis com o pool de armazenamento.

ulDefaultNumberofColumns

O número padrão de colunas com suporte no pool de armazenamento.

ulDataAvailabilityHint

Uma dica do cliente que indica a importância colocada na disponibilidade de dados. Os valores variam de 0 (Não Importante) a 10 (Muito Importante).

ulAccessRandomnessHint

Uma dica do cliente que indica a aleatoriedade do acesso a dados. Os valores variam de 0 (Inteiramente Sequencial) a 10 (Inteiramente Aleatório).

ulAccessDirectionHint

Uma dica do cliente que indica a direção do acesso aos dados. Os valores variam de 0 (Inteiramente Lido) a 10 (Gravação inteira).

ulAccessSizeHint

Uma dica do cliente que indica o tamanho de acesso ideal em megabytes.

ulAccessLatencyHint

Uma dica do cliente que indica a importância da latência de acesso para o cliente. Os valores variam de 0 (Não Importante) a 10 (Muito Importante).

ulAccessBandwidthWeightHint

Uma dica do cliente que indica a importância da alta largura de banda. Os valores variam de 0 (Não Importante) a 10 (Muito Importante).

ulStorageCostHint

Uma dica do cliente que indica a importância do custo de armazenamento para o cliente. Os valores variam de 0 (Não Importante) a 10 (Muito Importante). Se o custo de armazenamento for muito importante para o cliente, um valor de 10 indica que o cliente prefere provisionar o pool usando armazenamento de menor custo.

ulStorageEfficiencyHint

Uma dica do cliente que indica a importância da eficiência de armazenamento para o cliente. Os valores variam de 0 (Não Importante) a 10 (Muito Importante).

ulNumOfCustomAttributes

O número de atributos personalizados definidos para o pool de armazenamento.

pPoolCustomAttributes

Uma matriz de estruturas de VDS_POOL_CUSTOM_ATTRIBUTES . Cada estrutura contém um atributo personalizado definido para o pool de armazenamento.

bReserved1

Este membro é reservado para uso futuro. Não use.

bReserved2

Este membro é reservado para uso futuro. Não use.

ulReserved1

Este membro é reservado para uso futuro. Não use.

ulReserved2

Este membro é reservado para uso futuro. Não use.

ullReserved1

Este membro é reservado para uso futuro. Não use.

ullReserved2

Este membro é reservado para uso futuro. Não use.

Comentários

Se um atributo for definido para um pool de armazenamento, essa configuração de atributo deverá ser aplicada a todas as extensões de unidade que compõem o pool.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho vdshwprv.h

Confira também

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes