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