estrutura DISK_CACHE_INFORMATION (ntdddisk.h)

A estrutura DISK_CACHE_INFORMATION é usada com a solicitação IOCTL_DISK_GET_CACHE_INFORMATION para recuperar informações de cache.

Sintaxe

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

Membros

ParametersSavable

Indica, quando definido como 1, que o dispositivo é capaz de salvar quaisquer parâmetros no armazenamento não volátil.

ReadCacheEnabled

Indica, quando definido como 1, que o cache de leitura está habilitado.

WriteCacheEnabled

Indica, quando definido como 1, que o cache de gravação está habilitado.

ReadRetentionPriority

Determina a probabilidade de vários tipos de dados permanecerem no cache. Por meio desse valor, por exemplo, os dados armazenados em cache de uma operação READ ou WRITE podem receber uma prioridade diferente dos dados armazenados em cache em outras circunstâncias, como operações de pré-busca. Portanto, um valor igual a EqualPriority indica que nenhum dado é mantido no cache de forma preferencial. Quando ReadRetentionPriority é definido como EqualPriority, todos os tipos de dados têm acesso igual à memória de cache. Por outro lado, um valor de KeepPrefetchedData indica que uma preferência deve ser dada a dados pré-buscados, enquanto um valor de KeepReadData indica que uma preferência deve ser dada aos dados armazenados em cache de uma operação READ. Para obter mais informações sobre os valores que podem ser atribuídos a esse membro, consulte a enumeração DISK_CACHE_RETENTION_PRIORITY .

WriteRetentionPriority

Confira a discussão em ReadRetentionPriority.

DisablePrefetchTransferLength

Desabilita a pré-busca. A pré-busca pode ser desabilitada sempre que o número de blocos solicitados exceder o valor em DisablePrefetchTransferLength. Quando zero, a pré-busca é desabilitada, independentemente do tamanho da solicitação de bloco.

PrefetchScalar

Quando TRUE, Indica que ScalarPrefetch.Maximum deve ser usado junto com o comprimento da transferência para calcular a quantidade de dados que podem ser pré-buscados. Quando FALSE, BlockPrefetch.Maximum será o número máximo de blocos de disco que podem ser pré-buscados.

DUMMYUNIONNAME

DUMMYUNIONNAME.ScalarPrefetch

DUMMYUNIONNAME.ScalarPrefetch.Minimum

Contém o multiplicador escalar do comprimento de transferência da solicitação quando PrefetchScalar é TRUE. Se PrefetchScalar for TRUE, o valor em ScalarPrefetch.Minimum será multiplicado pelo comprimento da transferência para obter a quantidade mínima de dados que podem ser pré-buscados no cache em uma operação de disco.

DUMMYUNIONNAME.ScalarPrefetch.Maximum

Contém o multiplicador escalar do comprimento de transferência da solicitação quando PrefetchScalar é TRUE. Se PrefetchScalar for TRUE, o valor em ScalarPrefetch.Maximum será multiplicado pelo comprimento da transferência para obter a quantidade máxima de dados que podem ser pré-buscados no cache em uma operação de disco.

DUMMYUNIONNAME.ScalarPrefetch.MaximumBlocks

Contém o tamanho máximo, em blocos, do comprimento da transferência.

DUMMYUNIONNAME.BlockPrefetch

DUMMYUNIONNAME.BlockPrefetch.Minimum

Contém o multiplicador escalar do comprimento de transferência da solicitação quando PrefetchScalar é TRUE. Se PrefetchScalar for TRUE, o valor em ScalarPrefetch.Minimum será multiplicado pelo comprimento da transferência para obter a quantidade mínima de dados que podem ser pré-buscados no cache em uma operação de disco.

DUMMYUNIONNAME.BlockPrefetch.Maximum

Contém o multiplicador escalar do comprimento de transferência da solicitação quando PrefetchScalar é TRUE. Se PrefetchScalar for TRUE, o valor em ScalarPrefetch.Maximum será multiplicado pelo comprimento da transferência para obter a quantidade máxima de dados que podem ser pré-buscados no cache em uma operação de disco.

Requisitos

Requisito	Valor
Cabeçalho	ntdddisk.h (inclua Ntdddisk.h)

Confira também

DISK_CACHE_INFORMATION

IOCTL_DISK_GET_CACHE_INFORMATION