structure STORAGE_WRITE_CACHE_PROPERTY (winioctl.h)

  • Article

Utilisé avec le code de contrôle IOCTL_STORAGE_QUERY_PROPERTY pour récupérer des informations sur la propriété de cache d’écriture d’un dispositif.

Syntaxe

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;

Membres

Version

Contient la taille de cette structure, en octets. La valeur de ce membre change à mesure que des membres sont ajoutés à la structure.

Size

Spécifie la taille totale des données retournées, en octets. Cela peut inclure des données qui suivent cette structure.

WriteCacheType

Valeur de l’énumération WRITE_CACHE_TYPE qui indique le type de cache d’écriture actuel.

Valeur Signification
WriteCacheTypeUnknown
0
 Le système ne peut pas signaler le type du cache d’écriture.
WriteCacheTypeNone
1
 L’appareil n’a pas de cache d’écriture.
WriteCacheTypeWriteBack
2
 L’appareil dispose d’un cache en écriture différée.
WriteCacheTypeWriteThrough
3
 L’appareil dispose d’un cache en écriture directe.

WriteCacheEnabled

Valeur de l’énumération WRITE_CACHE_ENABLE qui indique si le cache d’écriture est activé.

Valeur Signification
WriteCacheEnableUnknown
0
 Le système ne peut pas indiquer si le cache d’écriture de l’appareil est activé ou désactivé.
WriteCacheDisabled
1
 Le cache d’écriture de l’appareil est désactivé.
WriteCacheEnabled
2
 Le cache d’écriture de l’appareil est activé.

WriteCacheChangeable

Valeur de l’énumération WRITE_CACHE_CHANGE qui indique si l’hôte peut modifier les caractéristiques du cache d’écriture.

Valeur Signification
WriteCacheChangeUnknown
0
 Le système ne peut pas signaler la fonctionnalité de modification du cache d’écriture de l’appareil.
WriteCacheNotChangeable
1
 Le logiciel hôte ne peut pas modifier les caractéristiques du cache d’écriture de l’appareil
WriteCacheChangeable
2
 Le logiciel hôte peut modifier les caractéristiques du cache d’écriture de l’appareil

WriteThroughSupported

Valeur de l’énumération WRITE_THROUGH qui indique si l’appareil prend en charge la mise en cache en écriture.

Valeur Signification
WriteThroughUnknown
0
 Indique qu’aucune information n’est disponible concernant les fonctionnalités d’écriture directe de l’appareil.
WriteThroughNotSupported
1
 Indique que l’appareil ne prend pas en charge les opérations d’écriture directe.
WriteThroughSupported
2
 Indique que l’appareil prend en charge les opérations d’écriture directe.

FlushCacheSupported

Valeur BOOLEAN qui indique si l’appareil autorise le logiciel hôte à vider le cache de l’appareil. Si la valeur est TRUE, l’appareil permet au logiciel hôte de vider le cache de l’appareil. Si la valeur est FALSE, le logiciel hôte ne peut pas vider le cache de l’appareil.

UserDefinedPowerProtection

Valeur BOOLEAN qui indique si un utilisateur peut configurer les caractéristiques de protection de l’alimentation de l’appareil dans le Registre. Si la valeur EST TRUE, un utilisateur peut configurer les caractéristiques de protection de l’alimentation de l’appareil dans le Registre. Si la valeur est FALSE, l’utilisateur ne peut pas configurer les caractéristiques de protection de l’alimentation de l’appareil dans le Registre.

NVCacheEnabled

Valeur BOOLEAN qui indique si l’appareil dispose d’une batterie de secours pour le cache d’écriture. Si la valeur EST TRUE, l’appareil dispose d’une batterie de secours pour le cache d’écriture. Si la valeur est FALSE, l’appareil ne dispose pas d’une batterie de secours pour le cache de l’enregistreur.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

Structures de gestion des disques

IOCTL_STORAGE_QUERY_PROPERTY