CcSetFileSizesEx 함수(ntifs.h)

CcSetFileSizesEx 루틴은 크기가 변경된 캐시된 파일에 대한 캐시 맵 및 섹션 개체를 업데이트합니다.

통사론

NTSTATUS CcSetFileSizesEx(
  PFILE_OBJECT   FileObject,
  PCC_FILE_SIZES FileSizes
);

매개 변수

FileObject

[in] 캐시된 파일의 파일 개체에 대한 포인터입니다.

FileSizes

[in] 새 파일 크기 정보를 포함하는 CC_FILE_SIZES 구조체에 대한 포인터입니다.

반환 값

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

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

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

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

발언

파일 시스템은 다음 중 하나가 캐시된 파일에 변경될 때마다 CcSetFileSizesEx 호출하여 캐시 관리자 데이터 구조를 업데이트해야 합니다.

• 할당 크기가 증가합니다.

• 유효한 데이터 길이가 줄어듭니다.

• 유효한 데이터 길이는 캐시되지 않은 I/O 작업으로 증가합니다.

• 파일 크기가 증가하거나 줄어듭니다.

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

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

파일을 캐시하려면 CcInitializeCacheMap사용합니다.

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

요구 사항

참고 항목

ccInitializeCacheMap

CcSetCacheFileSizes