Condividi tramite


struttura VDS_POOL_ATTRIBUTES (vdshwprv.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Definisce gli attributi di un pool di archiviazione.

Sintassi

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;

Members

ullAttributeMask

Maschera che specifica gli attributi nella struttura definiti da questo pool di archiviazione.

Di seguito è riportato l'elenco dei flag di attributo validi. Ogni flag corrisponde a un membro nella struttura VDS_POOL_ATTRIBUTES . I bit inutilizzati sono riservati.

Valore Attributo definito dal pool di archiviazione
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

Valore di enumerazione VDS_RAID_TYPE che specifica il tipo RAID del pool di archiviazione. Se il pool di archiviazione non dispone di un tipo RAID specifico, impostare questo membro su VDS_RT_UNKNOWN e cancellare il flag di attributo VDS_POOL_ATTRIB_RAIDTYPE nel membro ullAttributeMask .

busType

Valore di enumerazione VDS_STORAGE_BUS_TYPE che specifica il tipo di bus delle unità nel pool di archiviazione.

pwszIntendedUsage

Stringa che specifica l'utilizzo del pool di archiviazione. In genere, ciò può indicare l'applicazione che usa il pool di archiviazione ,ad esempio "SQL" o "Exchange" o la funzione aziendale che usa il pool di archiviazione (ad esempio, "Finance" o "Human Resources").

bSpinDown

TRUE se le unità nel pool di archiviazione vengono ruotate automaticamente per ridurre l'utilizzo dell'alimentazione o FALSE in caso contrario.

bIsThinProvisioned

TRUE se il thin provisioning del pool di archiviazione è thin provisioning o FALSE in caso contrario. Se il thin provisioning del pool viene eseguito, il numero di byte nello spazio utilizzato del pool potrebbe essere inferiore al numero di byte nello spazio di cui è stato effettuato il provisioning del pool. Il numero di byte nello spazio di cui è stato effettuato il provisioning viene archiviato nel membro ullProvisionedSpace di questa struttura. Il numero di byte nello spazio utilizzato viene archiviato nel membro ullTotalConsumedSpace della struttura VDS_STORAGE_POOL_PROP . Quando un provider hardware imposta questo membro su TRUE, deve anche impostare il membro del tipo della struttura VDS_STORAGE_POOL_PROP su VDS_SPT_CONCRETE.

ullProvisionedSpace

Se il thin provisioning del pool viene eseguito, questo membro specifica lo spazio, in byte, di cui viene effettuato il provisioning per il pool. Il valore di questo membro deve essere maggiore o uguale al valore del membro ullTotalConsumedSpace della struttura VDS_STORAGE_POOL_PROP .

bNoSinglePointOfFailure

TRUE se non è presente alcun singolo punto di errore nel pool o FALSE in caso contrario.

ulDataRedundancyMax

Numero massimo di copie complete dei dati che possono essere mantenuti in questo pool di archiviazione.

ulDataRedundancyMin

Numero minimo di copie complete dei dati che possono essere mantenuti in questo pool di archiviazione.

ulDataRedundancyDefault

Numero predefinito di copie complete dei dati gestiti in questo pool di archiviazione.

ulPackageRedundancyMax

Numero massimo di unità che possono essere usate nel pool di archiviazione per garantire la ridondanza del pacchetto. La ridondanza del pacchetto indica il numero di unità che possono avere esito negativo nel pool di archiviazione senza comportare una perdita di dati.

ulPackageRedundancyMin

Numero minimo di unità che possono essere usate nel pool di archiviazione per garantire la ridondanza dei pacchetti. La ridondanza del pacchetto indica il numero di unità che possono avere esito negativo nel pool di archiviazione senza comportare una perdita di dati.

ulPackageRedundancyDefault

Numero predefinito di unità usate nel pool di archiviazione per garantire la ridondanza del pacchetto. La ridondanza del pacchetto indica il numero di unità che possono avere esito negativo nel pool di archiviazione senza comportare una perdita di dati.

ulStripeSize

Dimensione di striping mirror o parità, in byte, del pool di archiviazione se il pool viene sottoposto a striping (con o senza parità).

ulStripeSizeMax

Dimensioni massime di striping, in byte, supportate dal pool di archiviazione.

ulStripeSizeMin

Dimensioni minime di striping, in byte, supportate dal pool di archiviazione.

ulDefaultStripeSize

Dimensioni di striping predefinite, in byte, supportate dal pool di archiviazione.

ulNumberOfColumns

Numero di colonne del pool di archiviazione se il pool viene sottoposto a striping (con o senza parità).

ulNumberOfColumnsMax

Numero massimo di colonne supportate dal pool di archiviazione.

ulNumberOfColumnsMin

Numero minimo di colonne supportate dal pool di archiviazione.

ulDefaultNumberofColumns

Numero predefinito di colonne supportate dal pool di archiviazione.

ulDataAvailabilityHint

Hint del client che indica l'importanza posta sulla disponibilità dei dati. I valori sono compresi tra 0 (non importante) e 10 (molto importante).

ulAccessRandomnessHint

Hint del client che indica la casualità dell'accesso ai dati. I valori sono compresi tra 0 (interamente sequenziale) e 10 (interamente casuale).

ulAccessDirectionHint

Hint del client che indica la direzione dell'accesso ai dati. I valori sono compresi tra 0 (interamente letti) e 10 (interamente scritti).

ulAccessSizeHint

Suggerimento del client che indica le dimensioni ottimali di accesso in megabyte.

ulAccessLatencyHint

Hint del client che indica l'importanza della latenza di accesso al client. I valori sono compresi tra 0 (non importante) e 10 (molto importante).

ulAccessBandwidthWeightHint

Suggerimento del client che indica l'importanza della larghezza di banda elevata. I valori sono compresi tra 0 (non importante) e 10 (molto importante).

ulStorageCostHint

Suggerimento del client che indica l'importanza del costo di archiviazione per il client. I valori sono compresi tra 0 (non importante) e 10 (molto importante). Se il costo di archiviazione è molto importante per il client, il valore 10 indica che il client preferisce effettuare il provisioning del pool usando un'archiviazione con costi inferiori.

ulStorageEfficiencyHint

Suggerimento del client che indica l'importanza dell'efficienza di archiviazione per il client. I valori sono compresi tra 0 (non importante) e 10 (molto importante).

ulNumOfCustomAttributes

Numero di attributi personalizzati definiti per il pool di archiviazione.

pPoolCustomAttributes

Matrice di strutture VDS_POOL_CUSTOM_ATTRIBUTES . Ogni struttura contiene un attributo personalizzato definito per il pool di archiviazione.

bReserved1

Questo membro è riservato per usi futuri. Non usare.

bReserved2

Questo membro è riservato per usi futuri. Non usare.

ulReserved1

Questo membro è riservato per usi futuri. Non usare.

ulReserved2

Questo membro è riservato per usi futuri. Non usare.

ullReserved1

Questo membro è riservato per usi futuri. Non usare.

ullReserved2

Questo membro è riservato per usi futuri. Non usare.

Commenti

Se un attributo è impostato per un pool di archiviazione, tale impostazione dell'attributo deve essere applicata a tutti gli extent di unità che costituiscono il pool.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione vdshwprv.h

Vedi anche

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes