CcCopyReadEx 関数 (ntifs.h)

[アーティクル]
07/11/2023

CcCopyReadEx ルーチンは、キャッシュされたファイルからユーザーバッファーにデータをコピーします。操作の I/O バイト数は、発行スレッドに対して課金されます。

構文

BOOLEAN CcCopyReadEx(
  [in]  PFILE_OBJECT     FileObject,
  [in]  PLARGE_INTEGER   FileOffset,
  [in]  ULONG            Length,
  [in]  BOOLEAN          Wait,
  [out] PVOID            Buffer,
  [out] PIO_STATUS_BLOCK IoStatus,
  [in]  PETHREAD         IoIssuerThread
);

パラメーター

[in] FileObject

データの読み取り元となるキャッシュされたファイルのファイルオブジェクトへのポインター。

[in] FileOffset

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

[in] Length

読み取るデータの長さ (バイト単位)。

[in] Wait

すべてのデータがコピーされるまで呼び出し元を待機状態にできる場合は TRUE、それ以外の場合は FALSE に設定します。

[out] Buffer

データのコピー先となるバッファーへのポインター。

[out] IoStatus

最終的な完了状態と操作に関する情報を受け取る呼び出し元によって割り当てられた構造体へのポインター。すべてのデータが正常にコピーされない場合、 IoStatus.Information にはコピーされた実際のバイト数が含まれます。

[in] IoIssuerThread

読み取り要求を発行するスレッド。ディスク I/O アカウンティングが有効になっているファイルシステムの場合、これは I/O が課金されるスレッドです。 IoIssuerThread が NULL の場合、I/O は現在のスレッドに対して課金されます。

戻り値

CcCopyReadEx ルーチンは、データが正常にコピーされた場合は TRUE、それ以外の場合は FALSE を返します。

注釈

Wait が TRUE の場合、CcCopyReadEx はコピー要求を完了し、TRUE を返す保証があります。キャッシュされたファイルの必要なページが既にメモリに存在する場合、データはすぐにコピーされ、ブロックは行われません。必要なページが常駐していない場合、呼び出し元は、必要なすべてのページが常駐し、データをコピーできるようになるまで待機状態になります。

Wait が FALSE の場合、CcCopyReadEx はブロックを拒否し、キャッシュされたファイルの必要なページがまだメモリに存在していない場合は FALSE を返します。

FileOffset と Length は 、キャッシュされたファイルのサイズ以下である必要があります。そうしないと、アサーションエラーが発生します。

エラーが発生した場合、 CcCopyReadEx は特定のエラーの状態例外を発生させます。たとえば、プール割り当てエラーが発生した場合、 CcCopyReadEx は STATUS_INSUFFICIENT_RESOURCES 状態の例外を発生させます。I/O エラーが発生した場合、 CcCopyReadEx は I/O エラーの状態例外を発生させます。そのため、エラーが発生したかどうかを制御するには、ドライバーは、CcCopyReadEx の呼び出しを try-except ステートメントまたは try-finally ステートメントでラップする必要があります。

ファイルをキャッシュするには、 CcInitializeCacheMap を使用します。

要件

要件	値
サポートされている最小のクライアント	Windows 8
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h、FltKernel.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL