CcSetCacheFileSizes 함수(ntifs.h)

CcSetCacheFileSizes 함수는 섹션 개체 포인터별로 캐시 관리자 파일 크기를 설정합니다.

구문

NTSTATUS CcSetCacheFileSizes(
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] PCC_FILE_SIZES           FileSizes
);

매개 변수

[in] SectionObjectPointer

섹션 개체 정보를 포함하는 SECTION_OBJECT_POINTERS 구조체에 대한 포인터입니다.

[in] FileSizes

설정할 파일 크기를 지정하는 CC_FILE_SIZES 구조체에 대한 포인터입니다.

반환 값

CcSetCacheFileSizes 는 파일 크기가 성공적으로 변경된 경우 STATUS_SUCCESS 반환하고 제거가 필요한 경우 제거에 성공했습니다. 그렇지 않으면 STATUS_INSUFFICIENT_RESOURCES 같은 성공하지 못한 NSTATUS 코드를 반환하고 상태 예외가 발생할 수 있습니다.

오류 발생 상태 예외 발생과 관련하여 다음을 수행합니다.

• 작업으로 인해 CcSetCacheFileSizes 가 파일을 플러시 및/또는 제거하면 CcSetCacheFileSizes 에서 오류가 발생하지 않습니다. 플러시 또는 제거 작업의 적절한 성공이 아닌 NTSTATUS 코드를 반환합니다.

• 작업으로 인해 CcSetCacheFileSizes 가 섹션을 확장하면 CcSetCacheFileSizes 는 이 확장 중에 발생하는 모든 오류가 발생합니다.

설명

작업으로 인해 CcSetCacheFileSizes가 섹션을 확장하고 오류가 발생하면 CcSetCacheFileSizes는 특정 오류에 대한 상태 예외를 발생합니다. 예를 들어 풀 할당 오류가 발생하면 CcSetCacheFileSizes 는 STATUS_INSUFFICIENT_RESOURCES 예외를 발생합니다. 따라서 오류가 발생하는 경우 제어하려면 드라이버는 try-except 또는 try-finally 문에서 CcSetCacheFileSizes에 대한 호출을 래핑해야 합니다.

파일 시스템은 캐시 맵이 유효한지 확인해야 하며 이 호출 기간 동안 계속 유지됩니다.

캐시된 파일의 크기를 얻으려면 SectionObjectPointer 를 CcGetCacheFileSize에 전달합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11, 버전 22H2
머리글	ntifs.h

추가 정보

CcGetCacheFileSize

CcSetFileSizesEx