Compartir a través de


estructura DISK_CACHE_INFORMATION (winioctl.h)

Proporciona información sobre la caché de disco. Esta estructura la usan los códigos de control IOCTL_DISK_GET_CACHE_INFORMATION y IOCTL_DISK_SET_CACHE_INFORMATION .

Sintaxis

typedef struct _DISK_CACHE_INFORMATION {
  BOOLEAN                       ParametersSavable;
  BOOLEAN                       ReadCacheEnabled;
  BOOLEAN                       WriteCacheEnabled;
  DISK_CACHE_RETENTION_PRIORITY ReadRetentionPriority;
  DISK_CACHE_RETENTION_PRIORITY WriteRetentionPriority;
  WORD                          DisablePrefetchTransferLength;
  BOOLEAN                       PrefetchScalar;
  union {
    struct {
      WORD Minimum;
      WORD Maximum;
      WORD MaximumBlocks;
    } ScalarPrefetch;
    struct {
      WORD Minimum;
      WORD Maximum;
    } BlockPrefetch;
  } DUMMYUNIONNAME;
} DISK_CACHE_INFORMATION, *PDISK_CACHE_INFORMATION;

Miembros

ParametersSavable

Indica si el dispositivo es capaz de guardar los parámetros en el almacenamiento no volátil.

ReadCacheEnabled

Indica si la memoria caché de lectura está habilitada.

WriteCacheEnabled

Indica si la caché de escritura está habilitada.

ReadRetentionPriority

Determina la probabilidad de que los datos almacenados en caché de una operación de lectura permanezcan en la memoria caché. Estos datos pueden tener una prioridad diferente a los datos almacenados en caché en otras circunstancias, como desde una operación de captura previa.

Este miembro puede ser uno de los siguientes valores del tipo de enumeración DISK_CACHE_RETENTION_PRIORITY .

Valor Significado
EqualPriority
0
No se mantiene ningún dato en la memoria caché de forma preferencial.
KeepPrefetchedData
1
Se debe dar una preferencia a los datos de captura previa.
KeepReadData
2
Se debe dar una preferencia a los datos almacenados en caché desde una operación de lectura.

WriteRetentionPriority

Determina la probabilidad de que los datos almacenados en caché de una operación de escritura permanezcan en la memoria caché. Estos datos pueden tener una prioridad diferente a los datos almacenados en caché en otras circunstancias, como desde una operación de captura previa.

DisablePrefetchTransferLength

Deshabilita la captura previa. La captura previa puede deshabilitarse siempre que el número de bloques solicitados supere el valor de DisablePrefetchTransferLength. Cuando es cero, la captura previa está deshabilitada independientemente del tamaño de la solicitud de bloque.

PrefetchScalar

Si este miembro es TRUE, la unión es una estructura ScalarPrefetch . De lo contrario, la unión es una estructura BlockPrefetch .

DUMMYUNIONNAME

DUMMYUNIONNAME.ScalarPrefetch

DUMMYUNIONNAME.ScalarPrefetch.Minimum

Multiplicador escalar de la longitud de transferencia de la solicitud. Este miembro solo es válido cuando PrefetchScalar es TRUE. Cuando PrefetchScalar es TRUE, este valor se multiplica por la longitud de transferencia para obtener la cantidad mínima de datos que se pueden capturar previamente en la memoria caché en una operación de disco.

DUMMYUNIONNAME.ScalarPrefetch.Maximum

Multiplicador escalar de la longitud de transferencia de la solicitud. Este miembro solo es válido cuando PrefetchScalar es TRUE. Cuando PrefetchScalar es TRUE, este valor se multiplica por la longitud de transferencia para obtener la cantidad máxima de datos que se pueden capturar previamente en la memoria caché en una operación de disco.

DUMMYUNIONNAME.ScalarPrefetch.MaximumBlocks

Número máximo de bloques que se pueden capturar previamente.

DUMMYUNIONNAME.BlockPrefetch

DUMMYUNIONNAME.BlockPrefetch.Minimum

Cantidad mínima de datos que se pueden capturar previamente en la memoria caché en una operación de disco, como un número absoluto de bloques de disco. Este miembro solo es válido cuando PrefetchScalar es FALSE.

DUMMYUNIONNAME.BlockPrefetch.Maximum

Cantidad máxima de datos que se pueden capturar previamente en la memoria caché en una operación de disco, como un número absoluto de bloques de disco. Este miembro solo es válido cuando PrefetchScalar es FALSE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluya Windows.h)

Consulte también

IOCTL_DISK_GET_CACHE_INFORMATION

IOCTL_DISK_SET_CACHE_INFORMATION