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
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |