DISK_CACHE_INFORMATION-Struktur (winioctl.h)

Artikel
08/27/2023

Stellt Informationen zum Datenträgercache bereit. Diese Struktur wird von den IOCTL_DISK_GET_CACHE_INFORMATION- und IOCTL_DISK_SET_CACHE_INFORMATION-Steuerungscodes verwendet.

Syntax

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;

Member

ParametersSavable

Gibt an, ob das Gerät in der Lage ist, Parameter im nichtflüchtigen Speicher zu speichern.

ReadCacheEnabled

Gibt an, ob der Lesecache aktiviert ist.

WriteCacheEnabled

Gibt an, ob der Schreibcache aktiviert ist.

ReadRetentionPriority

Bestimmt die Wahrscheinlichkeit, dass Daten aus einem Lesevorgang im Cache zwischengespeichert werden. Diese Daten erhalten möglicherweise eine andere Priorität als Daten, die unter anderen Umständen zwischengespeichert werden, z. B. aus einem Prefetch-Vorgang.

Dieser Member kann einer der folgenden Werte aus dem DISK_CACHE_RETENTION_PRIORITY Enumerationstyp sein.

Wert	Bedeutung
EqualPriority 0	Es werden keine Daten bevorzugt im Cache gespeichert.
KeepPrefetchedData 1	Voreingestellte Daten müssen bevorzugt werden.
KeepReadData 2	Für Daten, die aus einem Lesevorgang zwischengespeichert werden, ist eine Einstellung zu geben.

WriteRetentionPriority

Bestimmt die Wahrscheinlichkeit, dass Daten aus einem Schreibvorgang im Cache zwischengespeichert werden. Diese Daten erhalten möglicherweise eine andere Priorität als Daten, die unter anderen Umständen zwischengespeichert werden, z. B. aus einem Prefetch-Vorgang.

DisablePrefetchTransferLength

Deaktiviert prefetching. Prefetching kann deaktiviert werden, wenn die Anzahl der angeforderten Blöcke den Wert in DisablePrefetchTransferLength überschreitet. Bei null ist das Prefetching deaktiviert, unabhängig von der Größe der Blockanforderung.

PrefetchScalar

Wenn dieses Element TRUE ist, ist die Union eine ScalarPrefetch-Struktur . Andernfalls ist die Union eine BlockPrefetch-Struktur .

DUMMYUNIONNAME

DUMMYUNIONNAME.ScalarPrefetch

DUMMYUNIONNAME.ScalarPrefetch.Minimum

Der skalare Multiplikator der Übertragungslänge der Anforderung. Dieser Member ist nur gültig, wenn PrefetchScalartrue ist. Wenn PrefetchScalarTRUE ist, wird dieser Wert mit der Übertragungslänge multipliziert, um die minimale Datenmenge abzurufen, die vorab in den Cache auf einem Datenträgervorgang abgelegt werden kann.

DUMMYUNIONNAME.ScalarPrefetch.Maximum

Der skalare Multiplikator der Übertragungslänge der Anforderung. Dieser Member ist nur gültig, wenn PrefetchScalartrue ist. Wenn PrefetchScalarTRUE ist, wird dieser Wert mit der Übertragungslänge multipliziert, um die maximale Datenmenge abzurufen, die vorab in den Cache auf einem Datenträgervorgang abgelegt werden kann.

DUMMYUNIONNAME.ScalarPrefetch.MaximumBlocks

Die maximale Anzahl von Blöcken, die vorab abgerufen werden können.

DUMMYUNIONNAME.BlockPrefetch

DUMMYUNIONNAME.BlockPrefetch.Minimum

Die mindeste Datenmenge, die vorab in den Cache auf einem Datenträgervorgang als absolute Anzahl von Datenträgerblöcken abgelegt werden kann. Dieser Member ist nur gültig, wenn PrefetchScalarFALSE ist.

DUMMYUNIONNAME.BlockPrefetch.Maximum

Die maximale Menge an Daten, die in den Cache auf einem Datenträgervorgang als absolute Anzahl von Datenträgerblöcken vorab abgerufen werden kann. Dieser Member ist nur gültig, wenn PrefetchScalarFALSE ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

IOCTL_DISK_GET_CACHE_INFORMATION

IOCTL_DISK_SET_CACHE_INFORMATION

Share via