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 の