Fonction CcFlushCache (ntifs.h)

La routine CcFlushCache vide tout ou partie d’un fichier mis en cache sur le disque.

Syntaxe

void CcFlushCache(
  [in]            PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional]  PLARGE_INTEGER           FileOffset,
  [in]            ULONG                    Length,
  [out, optional] PIO_STATUS_BLOCK         IoStatus
);

Paramètres

[in] SectionObjectPointer

Pointeur vers une structure SECTION_OBJECT_POINTERS contenant les pointeurs d’objet de section de l’objet de fichier.

[in, optional] FileOffset

Pointeur vers une variable qui spécifie le décalage d’octets de départ dans le fichier mis en cache où les données doivent être vidées.

Si FileOffset est NULL, le fichier entier est vidé à partir du cache.

Si FileOffset n’est pas NULL, seule la plage d’octets spécifiée par FileOffset et longueur est vidée.

[in] Length

Longueur de la plage d’octets à vider, en commençant à FileOffset. Si FileOffset est NULL, longueur est ignorée.

[out, optional] IoStatus

Pointeur vers une structure qui reçoit l’état d’achèvement final et les informations relatives à l’opération de vidage. Si les données sont vidées correctement, IoStatus.Status contient STATUS_SUCCESS. Si toutes les données ne sont pas vidées correctement, IoStatus.Information contient le nombre réel d’octets qui ont été vidés. Sinon, IoStatus.Information contient la valeur donnée dans longueur .

Valeur de retour

Aucun

Remarques

ccFlushCache n’a aucun paramètre Wait. Ainsi, l’appelant doit être en mesure d’entrer un état d’attente jusqu’à ce que toutes les données soient vidées.

Pour mettre en cache un fichier, utilisez CcInitializeCacheMap.

Exigences

Voir aussi

CcCopyWrite

CcInitializeCacheMap

CcIsFileCached

ccPurgeCacheSection