CcSetCacheFileSizes, fonction (ntifs.h)
La fonction CcSetCacheFileSizes définit les tailles de fichier du gestionnaire de cache par pointeurs d’objet de section.
Syntaxe
NTSTATUS CcSetCacheFileSizes(
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] PCC_FILE_SIZES FileSizes
);
Paramètres
[in] SectionObjectPointer
Pointeur vers une structure SECTION_OBJECT_POINTERS qui contient les informations sur l’objet de section.
[in] FileSizes
Pointeur vers une structure CC_FILE_SIZES qui spécifie la taille de fichier à définir.
Valeur de retour
CcSetCacheFileSizes retourne STATUS_SUCCESS si la taille du fichier a été modifiée avec succès et, si une purge a été nécessaire pour que le vidage ait réussi. Sinon, il retourne un code NSTATUS non réussi, tel que STATUS_INSUFFICIENT_RESOURCES, et peut déclencher une exception d’état.
En ce qui concerne le déclenchement d’une exception d’état lors de l’erreur :
Si l’opération provoque CcSetCacheFileSizes vider et/ou vider le fichier, CcSetCacheFileSizes ne déclenche pas d’erreurs ; elle retourne simplement le code NTSTATUS non réussi approprié de l’opération de vidage ou de vidage.
Si l’opération provoque CcSetCacheFileSizes d’étendre la section, CcSetCacheFileSizes déclenchera une erreur lors de cette extension.
Remarques
Si l’opération provoque CcSetCacheFileSizes étendre la section et qu’une défaillance se produit, CcSetCacheFileSizes déclenche une exception d’état pour cet échec particulier. Par exemple, si un échec d’allocation de pool se produit, CcSetCacheFileSizes déclenche une exception STATUS_INSUFFICIENT_RESOURCES. Par conséquent, pour contrôler si une défaillance se produit, le pilote doit encapsuler l’appel à CcSetCacheFileSizes dans une instruction try-except ou try-finally.
Le système de fichiers doit s’assurer que le mappage de cache est valide et restera ainsi pendant la durée de cet appel.
Pour obtenir la taille du fichier mis en cache, passez SectionObjectPointer à CcGetCacheFileSize.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 22H2 |
| d’en-tête | ntifs.h |