CcFlushCache 関数 (ntifs.h)

[アーティクル]
03/10/2024

CcFlushCache ルーチンは、キャッシュされたファイルの全部または一部をディスクにフラッシュします。

構文

void CcFlushCache(
  [in]            PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional]  PLARGE_INTEGER           FileOffset,
  [in]            ULONG                    Length,
  [out, optional] PIO_STATUS_BLOCK         IoStatus
);

パラメーター

[in] SectionObjectPointer

ファイルオブジェクトのセクションオブジェクトポインターを含む SECTION_OBJECT_POINTERS 構造体へのポインター。

[in, optional] FileOffset

データをフラッシュするキャッシュファイル内の開始バイトオフセットを指定する変数へのポインター。

FileOffset が NULL の場合、ファイル全体がキャッシュからフラッシュされます。

FileOffset が NULL でない場合は、FileOffset と Length で指定されたバイト範囲のみがフラッシュされます。

[in] Length

FileOffset から始まる、フラッシュするバイト範囲の長さ。 FileOffset が NULL の場合、Length は無視されます。

[out, optional] IoStatus

最終完了状態とフラッシュ操作に関する情報を受け取る構造体へのポインター。データが正常にフラッシュされた場合、 IoStatus.Status にはSTATUS_SUCCESSが含まれます。すべてのデータが正常にフラッシュされない場合、 IoStatus.Information には、フラッシュされた実際のバイト数が含まれます。それ以外の場合、 IoStatus.Information には Length に指定された値が含まれます。