CcScheduleReadAhead 関数 (ntifs.h)

[アーティクル]
02/29/2024

CcScheduleReadAhead ルーチンは、キャッシュされたファイルに対して先読み ("遅延読み取り" とも呼ばれます) を実行します。 CcScheduleReadAhead を直接呼び出すべきではありません。代わりに CcReadAhead マクロを呼び出す必要があります。

構文

void CcScheduleReadAhead(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length
);

パラメーター

[in] FileObject

先行読み取りを実行するファイルのファイルオブジェクトへのポインター。

[in] FileOffset

最後の読み取りが発生したキャッシュされたファイル内の開始バイトオフセットを指定する変数へのポインター。

[in] Length

最後に読み取られた範囲の長さ (バイト単位)。

戻り値

なし

解説

CcReadAhead マクロは、CcScheduleReadAhead のラッパーです。 Length>= 256 の場合にのみ CcScheduleReadAhead を呼び出します。測定では、 CcScheduleReadAhead を呼び出して読み取りを小さくすると、実際にはパフォーマンスが低下していることが示されています。

CcReadAhead と CcScheduleReadAhead は、CcCopyRead、CcFastCopyRead、または CcMdlRead の呼び出しが成功した後にのみ呼び出すことができます。