CcSetCacheFileSizes, fonction (ntifs.h)

  • Article

La fonction CcSetCacheFileSizes définit les tailles de fichier du gestionnaire de cache par pointeur 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 retournée

CcSetCacheFileSizes retourne STATUS_SUCCESS si la taille du fichier a été correctement modifiée et, si un vidage était nécessaire, que le vidage a réussi. Sinon, elle retourne un code NSTATUS non réussi, tel que STATUS_INSUFFICIENT_RESOURCES, et peut déclencher une exception status.

Concernant le déclenchement d’une exception status en cas d’erreur :

  • Si l’opération entraîne le vidage et/ou le vidage du fichier par CcSetCacheFileSizes , 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 entraîne l’extension de la section par CcSetCacheFileSizes , CcSetCacheFileSizes déclenche toute erreur rencontrée pendant cette extension.

Remarques

Si l’opération entraîne l’extension de la section par CcSetCacheFileSizes et qu’un échec se produit, CcSetCacheFileSizes déclenche une exception status 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 prendre le contrôle en cas de défaillance, 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 du cache est valide et le restera pendant la durée de cet appel.

Pour obtenir la taille du fichier mis en cache, passez SectionObjectPointer à CcGetCacheFileSize.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11, version 22H2
En-tête ntifs.h

Voir aussi

CcGetCacheFileSize

CcSetFileSizesEx