struttura VDS_POOL_ATTRIBUTES (vds.h)

Articolo
03/08/2023

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

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