structure VDS_POOL_ATTRIBUTES (vdshwprv.h)

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]

Définit les attributs d’un pool de stockage.

Syntaxe

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;

Membres

ullAttributeMask

Masque qui spécifie les attributs de la structure définis par ce pool de stockage.

La liste des indicateurs d’attribut valides est la suivante. Chaque indicateur correspond à un membre dans la structure VDS_POOL_ATTRIBUTES . Les bits inutilisés sont réservés.

Valeur Attribut défini par le pool de stockage
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
0x40000000L
ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x80000000L
pPoolCustomAttributes

raidType

Valeur d’énumération VDS_RAID_TYPE qui spécifie le type RAID du pool de stockage. Si le pool de stockage n’a pas de type RAID spécifique, définissez ce membre sur VDS_RT_UNKNOWN et effacez l’indicateur d’attribut VDS_POOL_ATTRIB_RAIDTYPE dans le membre ullAttributeMask .

busType

Valeur d’énumération VDS_STORAGE_BUS_TYPE qui spécifie le type de bus des lecteurs dans le pool de stockage.

pwszIntendedUsage

Chaîne qui spécifie l’utilisation du pool de stockage. En règle générale, cela peut indiquer l’application qui utilise le pool de stockage (par exemple, « SQL » ou « Exchange ») ou la fonction métier qui utilise le pool de stockage (par exemple, « Finance » ou « Ressources humaines »).

bSpinDown

TRUE si les lecteurs du pool de stockage sont automatiquement mis hors service pour réduire la consommation d’énergie, ou FALSE dans le cas contraire.

bIsThinProvisioned

TRUE si le pool de stockage est provisionné de manière dynamique, ou FALSE dans le cas contraire. Si le pool est provisionné de manière dynamique, le nombre d’octets dans l’espace consommé du pool peut être inférieur au nombre d’octets dans l’espace provisionné du pool. (Le nombre d’octets dans l’espace provisionné est stocké dans le membre ullProvisionedSpace de cette structure. Le nombre d’octets dans l’espace consommé est stocké dans le membre ullTotalConsumedSpace de la structure VDS_STORAGE_POOL_PROP .) Lorsqu’un fournisseur de matériel définit ce membre sur TRUE, il doit également définir le membre de type de la structure VDS_STORAGE_POOL_PROP sur VDS_SPT_CONCRETE.

ullProvisionedSpace

Si le pool est provisionné de manière dynamique, ce membre spécifie l’espace, en octets, qui est approvisionné pour le pool. La valeur de ce membre doit être supérieure ou égale à la valeur du membre ullTotalConsumedSpace de la structure VDS_STORAGE_POOL_PROP .

bNoSinglePointOfFailure

TRUE s’il n’y a pas de point de défaillance unique dans le pool, ou FALSE dans le cas contraire.

ulDataRedundancyMax

Nombre maximal de copies complètes des données pouvant être conservées dans ce pool de stockage.

ulDataRedundancyMin

Nombre minimal de copies complètes des données pouvant être conservées dans ce pool de stockage.

ulDataRedundancyDefault

Nombre par défaut de copies complètes des données conservées dans ce pool de stockage.

ulPackageRedundancyMax

Nombre maximal de lecteurs pouvant être utilisés dans le pool de stockage pour garantir la redondance du package. La redondance du package indique le nombre de lecteurs qui peuvent échouer dans le pool de stockage sans entraîner de perte de données.

ulPackageRedundancyMin

Nombre minimal de lecteurs pouvant être utilisés dans le pool de stockage pour garantir la redondance du package. La redondance du package indique le nombre de lecteurs qui peuvent échouer dans le pool de stockage sans entraîner de perte de données.

ulPackageRedundancyDefault

Nombre par défaut de lecteurs utilisés dans le pool de stockage pour garantir la redondance du package. La redondance du package indique le nombre de lecteurs qui peuvent échouer dans le pool de stockage sans entraîner de perte de données.

ulStripeSize

Taille de la miroir ou de la bande de parité, en octets, du pool de stockage si le pool est entrelacé (avec ou sans parité).

ulStripeSizeMax

Taille de bande maximale, en octets, prise en charge par le pool de stockage.

ulStripeSizeMin

Taille de bande minimale, en octets, prise en charge par le pool de stockage.

ulDefaultStripeSize

Taille de bande par défaut, en octets, prise en charge par le pool de stockage.

ulNumberOfColumns

Nombre de colonnes du pool de stockage si le pool est par bandes (avec ou sans parité).

ulNumberOfColumnsMax

Nombre maximal de colonnes prises en charge par le pool de stockage.

ulNumberOfColumnsMin

Nombre minimal de colonnes prises en charge par le pool de stockage.

ulDefaultNumberofColumns

Nombre par défaut de colonnes prises en charge par le pool de stockage.

ulDataAvailabilityHint

Indicateur du client qui indique l’importance de la disponibilité des données. Les valeurs sont comprises entre 0 (non important) et 10 (très important).

ulAccessRandomnessHint

Indicateur du client qui indique le caractère aléatoire de l’accès aux données. Les valeurs vont de 0 (entièrement séquentiel) à 10 (entièrement aléatoire).

ulAccessDirectionHint

Indicateur du client qui indique la direction de l’accès aux données. Les valeurs sont comprises entre 0 (entièrement en lecture) et 10 (écriture complète).

ulAccessSizeHint

Indicateur du client qui indique la taille d’accès optimale en mégaoctets.

ulAccessLatencyHint

Indicateur du client qui indique l’importance de la latence d’accès au client. Les valeurs sont comprises entre 0 (non important) et 10 (très important).

ulAccessBandwidthWeightHint

Indicateur du client qui indique l’importance d’une bande passante élevée. Les valeurs sont comprises entre 0 (non important) et 10 (très important).

ulStorageCostHint

Indicateur du client qui indique l’importance du coût de stockage pour le client. Les valeurs sont comprises entre 0 (non important) et 10 (très important). Si le coût de stockage est très important pour le client, une valeur de 10 indique que le client préférerait provisionner le pool à l’aide d’un stockage à moindre coût.

ulStorageEfficiencyHint

Indicateur du client qui indique l’importance de l’efficacité du stockage pour le client. Les valeurs sont comprises entre 0 (non important) et 10 (très important).

ulNumOfCustomAttributes

Nombre d’attributs personnalisés définis pour le pool de stockage.

pPoolCustomAttributes

Tableau de structures VDS_POOL_CUSTOM_ATTRIBUTES . Chaque structure contient un attribut personnalisé qui est défini pour le pool de stockage.

bReserved1

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

bReserved2

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

ulReserved1

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

ulReserved2

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

ullReserved1

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

ullReserved2

Ce membre est réservé pour un usage ultérieur. Ne pas utiliser.

Remarques

Si un attribut est défini pour un pool de stockage, ce paramètre d’attribut doit s’appliquer à toutes les extensions de lecteur qui composent le pool.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête vdshwprv.h

Voir aussi

IVdsHwProviderStoragePools ::QueryStoragePools

IVdsStoragePool ::GetAttributes