estrutura DISK_CACHE_INFORMATION (winioctl.h)

  • Artigo

Fornece informações sobre o cache de disco. Essa estrutura é usada pelos códigos de controle IOCTL_DISK_GET_CACHE_INFORMATION e IOCTL_DISK_SET_CACHE_INFORMATION .

Sintaxe

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;

Membros

ParametersSavable

Indica se o dispositivo é capaz de salvar parâmetros no armazenamento nãovolatile.

ReadCacheEnabled

Indica se o cache de leitura está habilitado.

WriteCacheEnabled

Indica se o cache de gravação está habilitado.

ReadRetentionPriority

Determina a probabilidade de dados armazenados em cache de uma operação de leitura restante no cache. Esses dados podem receber uma prioridade diferente dos dados armazenados em cache em outras circunstâncias, como de uma operação de pré-busca.

Esse membro pode ser um dos seguintes valores do tipo de enumeração DISK_CACHE_RETENTION_PRIORITY .

Valor Significado
EqualPriority
0
 Nenhum dado é mantido no cache preferencialmente.
KeepPrefetchedData
1
 Uma preferência deve ser dada aos dados pré-buscados.
KeepReadData
2
 Uma preferência deve ser dada aos dados armazenados em cache de uma operação de leitura.

WriteRetentionPriority

Determina a probabilidade de dados armazenados em cache de uma operação de gravação restante no cache. Esses dados podem receber uma prioridade diferente dos dados armazenados em cache em outras circunstâncias, como de uma operação de pré-busca.

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

Se esse membro for TRUE, a união será uma estrutura ScalarPrefetch . Caso contrário, a união será uma estrutura BlockPrefetch .

DUMMYUNIONNAME

DUMMYUNIONNAME.ScalarPrefetch

DUMMYUNIONNAME.ScalarPrefetch.Minimum

O multiplicador escalar do comprimento de transferência da solicitação. Esse membro só é válido quando PrefetchScalar é TRUE. Quando PrefetchScalar é TRUE, esse valor é multiplicado pelo comprimento de 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

O multiplicador escalar do comprimento de transferência da solicitação. Esse membro só é válido quando PrefetchScalar é TRUE. Quando PrefetchScalar é TRUE, esse valor é multiplicado pelo comprimento de 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

O número máximo de blocos que podem ser pré-buscados.

DUMMYUNIONNAME.BlockPrefetch

DUMMYUNIONNAME.BlockPrefetch.Minimum

A quantidade mínima de dados que podem ser pré-buscados no cache em uma operação de disco, como um número absoluto de blocos de disco. Esse membro só é válido quando PrefetchScalar é FALSE.

DUMMYUNIONNAME.BlockPrefetch.Maximum

A quantidade máxima de dados que podem ser pré-buscados no cache em uma operação de disco, como um número absoluto de blocos de disco. Esse membro só é válido quando PrefetchScalar é FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

IOCTL_DISK_GET_CACHE_INFORMATION

IOCTL_DISK_SET_CACHE_INFORMATION