Compartir a través de


estructura VDS_POOL_ATTRIBUTES (vdshwprv.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Define los atributos de un grupo de almacenamiento.

Sintaxis

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;

Miembros

ullAttributeMask

Máscara que especifica los atributos de la estructura definida por este bloque de almacenamiento.

La lista de marcas de atributo válidas es la siguiente. Cada marca corresponde a un miembro de la estructura VDS_POOL_ATTRIBUTES . Los bits no usados están reservados.

Valor Atributo definido por el grupo de almacenamiento
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
0x8000000L
ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT
0x10000000L
ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT
0x20000000L
ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT
0x40000000L
ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x80000000L
pPoolCustomAttributes

raidType

Valor de enumeración VDS_RAID_TYPE que especifica el tipo RAID del bloque de almacenamiento. Si el bloque de almacenamiento no tiene un tipo RAID específico, establezca este miembro en VDS_RT_UNKNOWN y borre la marca de atributo VDS_POOL_ATTRIB_RAIDTYPE en el miembro ullAttributeMask .

busType

Valor de enumeración VDS_STORAGE_BUS_TYPE que especifica el tipo de bus de las unidades del bloque de almacenamiento.

pwszIntendedUsage

Cadena que especifica el uso del bloque de almacenamiento. Normalmente, esto puede indicar la aplicación que usa el bloque de almacenamiento (por ejemplo, "SQL" o "Exchange") o la función empresarial que usa el bloque de almacenamiento (por ejemplo, "Finanzas" o "Recursos humanos").

bSpinDown

TRUE si las unidades del bloque de almacenamiento se reducen automáticamente para reducir el uso de energía o FALSE en caso contrario.

bIsThinProvisioned

TRUE si el bloque de almacenamiento está aprovisionado fino o FALSE en caso contrario. Si el grupo está aprovisionado fino, el número de bytes en el espacio consumido del grupo podría ser menor que el número de bytes en el espacio aprovisionado del grupo. (El número de bytes del espacio aprovisionado se almacena en el miembro ullProvisionedSpace de esta estructura. El número de bytes del espacio consumido se almacena en el miembro ullTotalConsumedSpace de la estructura VDS_STORAGE_POOL_PROP ). Cuando un proveedor de hardware establece este miembro en TRUE, también debe establecer el miembro de tipo de la estructura de VDS_STORAGE_POOL_PROPen VDS_SPT_CONCRETE.

ullProvisionedSpace

Si el grupo está aprovisionado fino, este miembro especifica el espacio, en bytes, que se aprovisiona para el grupo. El valor de este miembro debe ser mayor o igual que el valor del miembro ullTotalConsumedSpace de la estructura VDS_STORAGE_POOL_PROP .

bNoSinglePointOfFailure

TRUE si no hay un único punto de error en el grupo o FALSE en caso contrario.

ulDataRedundancyMax

Número máximo de copias completas de los datos que se pueden mantener en este bloque de almacenamiento.

ulDataRedundancyMin

El número mínimo de copias completas de los datos que se pueden mantener en este bloque de almacenamiento.

ulDataRedundancyDefault

Número predeterminado de copias completas de los datos que se mantienen en este bloque de almacenamiento.

ulPackageRedundancyMax

Número máximo de unidades que se pueden usar en el bloque de almacenamiento para garantizar la redundancia del paquete. La redundancia del paquete indica el número de unidades que pueden producir errores en el bloque de almacenamiento sin provocar una pérdida de datos.

ulPackageRedundancyMin

Número mínimo de unidades que se pueden usar en el bloque de almacenamiento para garantizar la redundancia del paquete. La redundancia del paquete indica el número de unidades que pueden producir errores en el bloque de almacenamiento sin provocar una pérdida de datos.

ulPackageRedundancyDefault

El número predeterminado de unidades que se usan en el bloque de almacenamiento para garantizar la redundancia del paquete. La redundancia del paquete indica el número de unidades que pueden producir errores en el bloque de almacenamiento sin provocar una pérdida de datos.

ulStripeSize

Tamaño de franja de reflejo o paridad, en bytes, del bloque de almacenamiento si el grupo está seccionado (con o sin paridad).

ulStripeSizeMax

Tamaño máximo de franja, en bytes, que es compatible con el bloque de almacenamiento.

ulStripeSizeMin

Tamaño mínimo de franja, en bytes, que es compatible con el bloque de almacenamiento.

ulDefaultStripeSize

Tamaño de franja predeterminado, en bytes, que es compatible con el bloque de almacenamiento.

ulNumberOfColumns

Número de columnas del bloque de almacenamiento si el grupo está seccionado (con o sin paridad).

ulNumberOfColumnsMax

Número máximo de columnas admitidas por el bloque de almacenamiento.

ulNumberOfColumnsMin

Número mínimo de columnas admitidas por el bloque de almacenamiento.

ulDefaultNumberofColumns

Número predeterminado de columnas admitidas por el bloque de almacenamiento.

ulDataAvailabilityHint

Sugerencia del cliente que indica la importancia que se aplica a la disponibilidad de los datos. Los valores van de 0 (no importante) a 10 (muy importante).

ulAccessRandomnessHint

Sugerencia del cliente que indica la aleatoriedad del acceso a datos. Los valores oscilan entre 0 (completamente secuencial) y 10 (completamente aleatorio).

ulAccessDirectionHint

Sugerencia del cliente que indica la dirección del acceso a los datos. Los valores van de 0 (lectura completa) a 10 (escritura completa).

ulAccessSizeHint

Sugerencia del cliente que indica el tamaño de acceso óptimo en megabytes.

ulAccessLatencyHint

Sugerencia del cliente que indica la importancia de la latencia de acceso al cliente. Los valores van de 0 (no importante) a 10 (muy importante).

ulAccessBandwidthWeightHint

Sugerencia del cliente que indica la importancia de un ancho de banda alto. Los valores van de 0 (no importante) a 10 (muy importante).

ulStorageCostHint

Sugerencia del cliente que indica la importancia del costo de almacenamiento para el cliente. Los valores van de 0 (no importante) a 10 (muy importante). Si el costo de almacenamiento es muy importante para el cliente, un valor de 10 indica que el cliente prefiere aprovisionar el grupo mediante un almacenamiento de menor costo.

ulStorageEfficiencyHint

Sugerencia del cliente que indica la importancia de la eficiencia del almacenamiento en el cliente. Los valores van de 0 (no importante) a 10 (muy importante).

ulNumOfCustomAttributes

Número de atributos personalizados definidos para el bloque de almacenamiento.

pPoolCustomAttributes

Matriz de estructuras de VDS_POOL_CUSTOM_ATTRIBUTES . Cada estructura contiene un atributo personalizado definido para el bloque de almacenamiento.

bReserved1

Este miembro se reserva para uso futuro. No debe usarse.

bReserved2

Este miembro se reserva para uso futuro. No debe usarse.

ulReserved1

Este miembro se reserva para uso futuro. No debe usarse.

ulReserved2

Este miembro se reserva para uso futuro. No debe usarse.

ullReserved1

Este miembro se reserva para uso futuro. No debe usarse.

ullReserved2

Este miembro se reserva para uso futuro. No debe usarse.

Comentarios

Si se establece un atributo para un grupo de almacenamiento, esa configuración de atributo debe aplicarse a todas las extensiones de unidad que componen el grupo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado vdshwprv.h

Consulte también

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes