struttura DISK_CACHE_INFORMATION (winioctl.h)

Articolo
08/27/2023

Fornisce informazioni sulla cache del disco. Questa struttura viene utilizzata dai codici di controllo IOCTL_DISK_GET_CACHE_INFORMATION e IOCTL_DISK_SET_CACHE_INFORMATION .

Sintassi

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;

Members

ParametersSavable

Indica se il dispositivo è in grado di salvare i parametri nell'archiviazione non volatile.

ReadCacheEnabled

Indica se la cache di lettura è abilitata.

WriteCacheEnabled

Indica se la cache di scrittura è abilitata.

ReadRetentionPriority

Determina la probabilità di dati memorizzati nella cache da un'operazione di lettura rimanente nella cache. Questi dati potrebbero avere una priorità diversa rispetto ai dati memorizzati nella cache in altre circostanze, ad esempio da un'operazione di prelettura.

Questo membro può essere uno dei valori seguenti dal tipo di enumerazione DISK_CACHE_RETENTION_PRIORITY .

Valore	Significato
EqualPriority 0	Nessun dato viene mantenuto nella cache su base preferenziale.
KeepPrefetchedData 1	È consigliabile assegnare una preferenza ai dati prelettura.
KeepReadData 2	Una preferenza deve essere assegnata ai dati memorizzati nella cache da un'operazione di lettura.

WriteRetentionPriority

Determina la probabilità di dati memorizzati nella cache da un'operazione di scrittura rimanente nella cache. Questi dati potrebbero avere una priorità diversa rispetto ai dati memorizzati nella cache in altre circostanze, ad esempio da un'operazione di prelettura.

DisablePrefetchTransferLength

Disabilita il prelettura. La prelettura potrebbe essere disabilitata ogni volta che il numero di blocchi richiesti supera il valore in DisablePrefetchTransferLength. Se zero, la prelettura viene disabilitata indipendentemente dalle dimensioni della richiesta di blocco.

PrefetchScalar

Se questo membro è TRUE, l'unione è una struttura ScalarPrefetch . In caso contrario, l'unione è una struttura BlockPrefetch .

DUMMYUNIONNAME

DUMMYUNIONNAME.ScalarPrefetch

DUMMYUNIONNAME.ScalarPrefetch.Minimum

Moltiplicatore scalare della lunghezza di trasferimento della richiesta. Questo membro è valido solo quando PrefetchScalar è TRUE. Quando PrefetchScalar è TRUE, questo valore viene moltiplicato per la lunghezza del trasferimento per ottenere la quantità minima di dati che è possibile recuperare nella cache in un'operazione su disco.

DUMMYUNIONNAME.ScalarPrefetch.Maximum

Moltiplicatore scalare della lunghezza di trasferimento della richiesta. Questo membro è valido solo quando PrefetchScalar è TRUE. Quando PrefetchScalar è TRUE, questo valore viene moltiplicato per la lunghezza del trasferimento per ottenere la quantità massima di dati che è possibile recuperare nella cache in un'operazione su disco.

DUMMYUNIONNAME.ScalarPrefetch.MaximumBlocks

Numero massimo di blocchi che possono essere prelettura.

DUMMYUNIONNAME.BlockPrefetch

DUMMYUNIONNAME.BlockPrefetch.Minimum

Quantità minima di dati che è possibile recuperare nella cache in un'operazione su disco, come numero assoluto di blocchi di disco. Questo membro è valido solo quando PrefetchScalar è FALSE.

DUMMYUNIONNAME.BlockPrefetch.Maximum

Quantità massima di dati che è possibile recuperare nella cache in un'operazione su disco, come numero assoluto di blocchi di disco. Questo membro è valido solo quando PrefetchScalar è FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

IOCTL_DISK_GET_CACHE_INFORMATION

IOCTL_DISK_SET_CACHE_INFORMATION

Condividi tramite