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
Header	ntifs.h

こちらもご覧ください

CcGetCacheFileSize

CcSetFileSizesEx