次の方法で共有

CcZeroData 関数 (ntifs.h)

  • [アーティクル]

CcZeroData ルーチンは、キャッシュされたファイルまたはキャッシュされていないファイル内の指定されたバイト範囲をゼロにします。

手記

このルーチンは、ファイルの有効なデータ長を超えるファイルの 0 個の部分にのみ呼び出す必要があります。 ccZeroData は、ファイルの以前に書き込まれたデータを変更しません。 ファイルの有効なデータ長までのファイルの一部である以前に書き込まれたデータを 0 にするには、ccCopyWrite呼び出すか、または他のキャッシュされた書き込みインターフェイスのいずれかを呼び出します。

構文

BOOLEAN CcZeroData(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER StartOffset,
  [in] PLARGE_INTEGER EndOffset,
  [in] BOOLEAN        Wait
);

パラメーター

[in] FileObject

バイト範囲がゼロになるファイルの FILE_OBJECT へのポインター。

[in] StartOffset

ゼロにする最初のバイトへのファイル内のバイト オフセットを指定する変数へのポインター。

[in] EndOffset

ファイル内で、ゼロにする最後のバイトへのバイト オフセットを指定する変数へのポインター。

[in] Wait

呼び出し元 バイト範囲全体がゼロになるまで待機状態にする必要がある場合は、TRUE に設定します。 それ以外の場合、このパラメーターは FALSEに設定されます。

戻り値

ccZeroData は、データが正常にゼロになった場合 TRUE を返します。それ以外の場合は、FALSE返します。

備考

ゼロにするファイルは、キャッシュすることもキャッシュしない場合もあります。 ただし、ファイルがキャッシュされていない場合は、StartOffset 値と EndOffset の値の両方がボリュームのセクター サイズの倍数である必要があります。

プールの割り当てエラーが発生し、待機 が TRUE指定された場合、ccZeroData STATUS_INSUFFICIENT_RESOURCES例外が発生します。 プールの割り当てエラーが発生し、待機 が FALSEとして指定された場合、ccZeroData は FALSE返しますが、例外は発生しません。

指定された FileObject でキャッシュが有効になっていないが、キャッシュがストリーム上に存在する場合 (つまり、同じファイルの別のファイル オブジェクトでキャッシュが有効になっている)、ゼロ処理は書き込みスルー キャッシュが有効になっているかのように扱われます。

待機 が TRUEに設定されている場合、CcZeroData はゼロ データ要求を完了し、TRUE返す必要があります。 キャッシュされたファイルの必要なページが既にメモリに常駐している場合、データはすぐにゼロになり、ブロックは発生しません。 必要なページが常駐していない場合、呼び出し元は、必要なすべてのページが常駐状態になり、データをゼロにできるまで待機状態になります。

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

プールの割り当てエラーが発生した場合、ccZeroData STATUS_INSUFFICIENT_RESOURCES例外が発生します。 ccZeroData IO エラーを含む他のエラーが発生した場合、エラーは呼び出し元に発生します。

Windows Vista 以降の Windows オペレーティング システムの場合、CcZeroData の動作は次のとおりです。

  • ストリームがキャッシュされ、write_throughされている場合、startOffset をセクターアラインする必要はありません。
  • EndOffset が揃っていない場合は、次のセクター サイズに切り上げられます。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000。 Vista 以降のオペレーティング システムの変更については、「解説」を参照してください。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Fltkernel.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

関連項目

ccInitializeCacheMap の

CcIsFileCached

FILE_OBJECT