estructura VDS_HINTS2 (vds.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.]

Contiene las sugerencias automagic para un LUN en un bloque de almacenamiento.

Sintaxis

typedef struct _VDS_HINTS2 {
  ULONGLONG            ullHintMask;
  ULONGLONG            ullExpectedMaximumSize;
  ULONG                ulOptimalReadSize;
  ULONG                ulOptimalReadAlignment;
  ULONG                ulOptimalWriteSize;
  ULONG                ulOptimalWriteAlignment;
  ULONG                ulMaximumDriveCount;
  ULONG                ulStripeSize;
  ULONG                ulReserved1;
  ULONG                ulReserved2;
  ULONG                ulReserved3;
  BOOL                 bFastCrashRecoveryRequired;
  BOOL                 bMostlyReads;
  BOOL                 bOptimizeForSequentialReads;
  BOOL                 bOptimizeForSequentialWrites;
  BOOL                 bRemapEnabled;
  BOOL                 bReadBackVerifyEnabled;
  BOOL                 bWriteThroughCachingEnabled;
  BOOL                 bHardwareChecksumEnabled;
  BOOL                 bIsYankable;
  BOOL                 bAllocateHotSpare;
  BOOL                 bUseMirroredCache;
  BOOL                 bReadCachingEnabled;
  BOOL                 bWriteCachingEnabled;
  BOOL                 bMediaScanEnabled;
  BOOL                 bConsistencyCheckEnabled;
  VDS_STORAGE_BUS_TYPE BusType;
  BOOL                 bReserved1;
  BOOL                 bReserved2;
  BOOL                 bReserved3;
  SHORT                sRebuildPriority;
} VDS_HINTS2, *PVDS_HINTS2;

Members

ullHintMask

Máscara de sugerencia de LUN. Cada uno de los miembros BOOL de esta estructura tiene una marca de sugerencia correspondiente que se puede establecer en la máscara. Si se establece la marca de sugerencia, se considera la sugerencia correspondiente. Si no se establece la marca de sugerencia, se omite la sugerencia. Las marcas de sugerencia se describen en la tabla siguiente.

ullExpectedMaximumSize

Tamaño máximo al que se espera que crezca el LUN, en bytes. El valor puede ser igual a, mayor o menor que el valor especificado en el parámetro ullSizeInBytes cuando se llama al método IVdsHwProviderStoragePools::CreateLunInStoragePool . Algunos proveedores usan este valor para reservar espacio para el LUN. Los proveedores que no pueden reservar espacio normalmente omiten este parámetro.

ulOptimalReadSize

Tamaño de lectura óptimo para el LUN, en bytes. Cero indica que no hay ningún tamaño de lectura óptimo.

ulOptimalReadAlignment

Alineación óptima de lectura con respecto al primer bloque lógico del LUN. Cero indica que no hay ninguna alineación de lectura óptima.

ulOptimalWriteSize

Tamaño de escritura óptimo para el LUN, en bytes. Cero indica que no hay un tamaño de escritura óptimo.

ulOptimalWriteAlignment

Alineación óptima de escritura con respecto al primer bloque lógico del LUN. Cero indica que no hay ninguna alineación de escritura óptima.

ulMaximumDriveCount

Número máximo de unidades que se van a contribuir al LUN. Cero indica que no hay número máximo de unidades. Este valor se puede usar para limitar el número de interleaves de franjas en un conjunto de franjas.

ulStripeSize

Tamaño de intercalación de reflejo o paridad, en bytes. Cero deja sin especificar el tamaño de la franja.

ulReserved1

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

ulReserved2

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

ulReserved3

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

bFastCrashRecoveryRequired

Si este miembro es TRUE, el tiempo de recuperación es limitado. Establezca la marca VDS_HINT_FASTCRASHRECOVERYREQUIRED en el miembro ullHintMask para indicar interés en este miembro.

bMostlyReads

Para optimizar un patrón de uso de lecturas principalmente (por ejemplo, mediante la creación de reflejos en lugar de la seccionamiento de paridad), establezca este miembro en TRUE. De lo contrario, establézcalo en FALSE. Establezca la marca VDS_HINT_MOSTLYREADS en el miembro ullHintMask para indicar interés en este miembro.

bOptimizeForSequentialReads

Para optimizar un patrón de uso de lecturas secuenciales, establezca este miembro en TRUE. De lo contrario, establézcalo en FALSE. Establecer los miembros bOptimizeForSequentialReads y bOptimizeForSequentialWrites en FALSE se optimizan para E/S aleatorias. Establezca la marca VDS_HINT_OPTIMIZEFORSEQUENTIALREADS en el miembro ullHintMask para indicar interés en este miembro.

bOptimizeForSequentialWrites

Para optimizar un patrón de uso de escritura secuencial, establezca este miembro en TRUE. De lo contrario, establézcalo en FALSE. Establecer los miembros bOptimizeForSequentialReads y bOptimizeForSequentialWrites en FALSE se optimizan para E/S aleatorias. Establezca la marca VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES en el miembro ullHintMask para indicar interés en este miembro.

bRemapEnabled

Si este miembro es TRUE, el proveedor reasigna las extensiones de LUN para impulsar las extensiones automáticamente. Si es FALSE, la asignación de extensiones de LUN a extensiones de unidad permanece fija después de la configuración de LUN, a menos que las extensiones se reasignan explícitamente para evitar bloques dañados. Establezca la marca VDS_HINT_REMAPENABLED en el miembro ullHintMask para indicar interés en este miembro.

bReadBackVerifyEnabled

Si este miembro es TRUE, el proveedor comprueba las escrituras en el LUN por readback. Si es FALSE, el proveedor no comprueba las escrituras. Establezca la marca VDS_HINT_READBACKVERIFYENABLED en el miembro ullHintMask para indicar interés en este miembro.

bWriteThroughCachingEnabled

Si este miembro es TRUE, el proveedor habilita el almacenamiento en caché de escritura en el LUN; si es FALSE, el proveedor no habilita el almacenamiento en caché de escritura a través. Establezca la marca VDS_HINT_WRITETHROUGHCACHINGENABLED en el miembro ullHintMask para indicar interés en este miembro.

bHardwareChecksumEnabled

Si este miembro es TRUE, el proveedor habilita una suma de comprobación en el LUN. Establezca la marca VDS_HINT_HARDWARECHECKSUMENABLED en el miembro ullHintMask para indicar interés en este miembro.

bIsYankable

Si este miembro es TRUE, las unidades que contribuyen al LUN se pueden quitar físicamente sin interrupciones significativas en el sistema (esto suele ser cierto cuando el LUN se compone de extensiones de solo unas pocas unidades). Si es FALSE, el LUN no se puede quitar sin interrupciones significativas en el sistema. Establezca la marca VDS_HINT_ISYANKABLE en el miembro ullHintMask para indicar interés en este miembro.

bAllocateHotSpare

TRUE si el cliente quiere asignar una unidad de reserva activa para este LUN o FALSE en caso contrario. Establezca la marca VDS_HINT_ALLOCATEHOTSPARE en el miembro ullHintMask para indicar interés en este miembro.

bUseMirroredCache

TRUE si el cliente quiere que este LUN use una memoria caché reflejada o FALSE en caso contrario. Establezca la marca VDS_HINT_USEMIRROREDCACHE en el miembro ullHintMask para indicar interés en este miembro.

bReadCachingEnabled

TRUE si el cliente quiere que el LUN use el almacenamiento en caché de lectura o FALSE en caso contrario. Establezca la marca VDS_HINT_READCACHINGENABLED en el miembro ullHintMask para indicar interés en este miembro.

bWriteCachingEnabled

TRUE si el cliente quiere que el LUN use el almacenamiento en caché de escritura o FALSE en caso contrario. Establezca la marca VDS_HINT_WRITECACHINGENABLED en el miembro ullHintMask para indicar interés en este miembro.

bMediaScanEnabled

TRUE si el cliente quiere habilitar el examen de medios para este LUN o FALSE en caso contrario. Establezca la marca VDS_HINT_MEDIASCANENABLED en el miembro ullHintMask para indicar interés en este miembro.

bConsistencyCheckEnabled

TRUE si el cliente quiere habilitar la comprobación de coherencia para este LUN o FALSE en caso contrario. Establezca la marca VDS_HINT_CONSISTENCYCHECKENABLED en el miembro ullHintMask para indicar interés en este miembro.

BusType

Valor de enumeración VDS_STORAGE_BUS_TYPE que especifica el tipo de bus para el LUN. Establezca la marca VDS_HINT_BUSTYPE en el miembro ullHintMask para indicar interés en este miembro.

bReserved1

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

bReserved2

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

bReserved3

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

sRebuildPriority

Prioridad de recompilación para el LUN. El valor puede oscilar entre 0 (prioridad más baja) y 15 (prioridad más alta).

Comentarios

El método IVdsHwProviderStoragePools::CreateLunInStoragePool pasa esta estructura como parámetro para proporcionar sugerencias para crear un LUN en un grupo de almacenamiento. Se pasa como parámetro en el método IVdsLun2::ApplyHints2 para aplicar un nuevo conjunto de sugerencias a un LUN. Además, se devuelve mediante el método IVdsLun2::QueryHints2 para notificar sugerencias aplicadas actualmente a un LUN o plex LUN, respectivamente.

Las sugerencias no son directivas para los implementadores. Aunque se espera que los implementadores hagan lo mejor posible para tener en cuenta las sugerencias, no están obligados a seguirlas. Los implementadores pueden optar por alternativas cuando no se pueden seguir sugerencias especificadas por motivos técnicos o cuando seguirlas pueden dar lugar a una configuración deficiente.

Requisitos

Consulte también

IVdsLun2::ApplyHints2

IVdsLun2::QueryHints2