STORAGE_WRITE_CACHE_PROPERTY-Struktur (winioctl.h)

  • Artikel

Wird mit dem IOCTL_STORAGE_QUERY_PROPERTY-Steuerungscode zum Abrufen von Informationen zur Schreibcacheeigenschaft eines Geräts verwendet.

Syntax

typedef struct _STORAGE_WRITE_CACHE_PROPERTY {
  DWORD              Version;
  DWORD              Size;
  WRITE_CACHE_TYPE   WriteCacheType;
  WRITE_CACHE_ENABLE WriteCacheEnabled;
  WRITE_CACHE_CHANGE WriteCacheChangeable;
  WRITE_THROUGH      WriteThroughSupported;
  BOOLEAN            FlushCacheSupported;
  BOOLEAN            UserDefinedPowerProtection;
  BOOLEAN            NVCacheEnabled;
} STORAGE_WRITE_CACHE_PROPERTY, *PSTORAGE_WRITE_CACHE_PROPERTY;

Member

Version

Enthält die Größe dieser Struktur in Bytes. Der Wert dieses Members ändert sich, wenn Member der -Struktur hinzugefügt werden.

Size

Gibt die Gesamtgröße der zurückgegebenen Daten in Bytes an. Dies kann Daten umfassen, die dieser Struktur folgen.

WriteCacheType

Ein Wert aus der WRITE_CACHE_TYPE-Enumeration , der den aktuellen Schreibcachetyp angibt.

Wert Bedeutung
WriteCacheTypeUnknown
0
 Das System kann den Typ des Schreibcaches nicht melden.
WriteCacheTypeNone
1
 Das Gerät verfügt nicht über einen Schreibcache.
WriteCacheTypeWriteBack
2
 Das Gerät verfügt über einen Rückschreibecache.
WriteCacheTypeWriteThrough
3
 Das Gerät verfügt über einen Schreibcache.

WriteCacheEnabled

Ein Wert aus der WRITE_CACHE_ENABLE-Enumeration , der angibt, ob der Schreibcache aktiviert ist.

Wert Bedeutung
WriteCacheEnableUnknown
0
 Das System kann nicht melden, ob der Schreibcache des Geräts aktiviert oder deaktiviert ist.
WriteCacheDisabled
1
 Der Schreibcache des Geräts ist deaktiviert.
WriteCacheEnabled
2
 Der Schreibcache des Geräts ist aktiviert.

WriteCacheChangeable

Ein Wert aus der WRITE_CACHE_CHANGE-Enumeration , der angibt, ob der Host die Merkmale des Schreibcaches ändern kann.

Wert Bedeutung
WriteCacheChangeUnknown
0
 Das System kann die Schreibcacheänderungsfunktion des Geräts nicht melden.
WriteCacheNotChangeable
1
 Die Hostsoftware kann die Merkmale des Schreibcaches des Geräts nicht ändern.
WriteCacheChangeable
2
 Die Hostsoftware kann die Merkmale des Schreibcaches des Geräts ändern.

WriteThroughSupported

Ein Wert aus der WRITE_THROUGH-Enumeration , der angibt, ob das Gerät das Zwischenspeichern von Schreibvorgängen unterstützt.

Wert Bedeutung
WriteThroughUnknown
0
 Gibt an, dass keine Informationen über die Schreibzugriffsfunktionen des Geräts verfügbar sind.
WriteThroughNotSupported
1
 Gibt an, dass das Gerät keine Schreibvorgänge unterstützt.
WriteThroughSupported
2
 Gibt an, dass das Gerät Schreibvorgänge unterstützt.

FlushCacheSupported

Ein BOOLEAN-Wert , der angibt, ob das Gerät es der Hostsoftware ermöglicht, den Gerätecache zu leeren. Bei TRUE ermöglicht das Gerät der Hostsoftware das Leeren des Gerätecaches. Bei FALSE kann die Hostsoftware den Gerätecache nicht leeren.

UserDefinedPowerProtection

Ein BOOLEscher Wert, der angibt, ob ein Benutzer die Energieschutzmerkmale des Geräts in der Registrierung konfigurieren kann. Wenn TRUE festgelegt ist, kann ein Benutzer die Energieschutzmerkmale des Geräts in der Registrierung konfigurieren. Wenn FALSE festgelegt ist, kann der Benutzer die Energieschutzmerkmale des Geräts in der Registrierung nicht konfigurieren.

NVCacheEnabled

Ein BOOLEscher Wert, der angibt, ob das Gerät über eine Akkusicherung für den Schreibcache verfügt. Bei TRUE verfügt das Gerät über eine Akkusicherung für den Schreibcache. Bei FALSE verfügt das Gerät nicht über eine Akkusicherung für den Writercache.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Siehe auch

Strukturen für die Datenträgerverwaltung

IOCTL_STORAGE_QUERY_PROPERTY