estructura VDS_POOL_ATTRIBUTES (vdshwprv.h)

Artículo
03/03/2024

[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