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.
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 |