CcPinMappedData 関数 (ntifs.h)

CcPinMappedData ルーチンは、キャッシュされたファイルの指定されたバイト範囲をピン留めします。

構文

BOOLEAN CcPinMappedData(
  [in]      PFILE_OBJECT   FileObject,
  [in]      PLARGE_INTEGER FileOffset,
  [in]      ULONG          Length,
  [in]      ULONG          Flags,
  [in, out] PVOID          *Bcb
);

パラメーター

[in] FileObject

データの範囲をピン留めするキャッシュされたファイルのファイル オブジェクトへのポインター。

[in] FileOffset

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

[in] Length

ピン留めするデータの長さ (バイト単位)。

[in] Flags

ピン留め操作の実行方法を指定するフラグのビットマスク。 次の値の 1 つ以上の ORed の組み合わせ:

[in, out] Bcb

最初の呼び出しでは、バッファー制御ブロック (BCB) へのポインターが返されます。 このポインターは、このバッファーの後続のすべての呼び出しで入力として指定する必要があります。

戻り値

CcPinMappedData は、キャッシュされたファイルのデータが正常にピン留めされた場合は TRUE を返 、それ以外の場合は FALSE 返します。

備考

CcPinMappedData から正常に戻った場合、CcMapData への呼び出しで以前にマップされたデータがキャッシュに固定され、指定した範囲のデータを安全に変更できることを保証します。 その後、呼び出し元が ccPinMappedDataによってピン留めされたデータ 変更する場合は、変更されたデータが最終的にディスクに書き込まれるように、CcSetDirtyPinnedData も呼び出す必要があります。

CcPinMappedData は、キャッシュ マネージャーのビュー境界を越えてデータをピン留めすることはできません。 キャッシュ・マネージャーは、256 KB アライン・ビューでシステム内のファイルを管理します。 (キャッシュ マネージャーのビュー サイズは、システム定義の定数 VACB_MAPPING_GRANULARITYで指定されます。この定数は、ntifs.hで 256 KB に設定されます)。ピン留めされた領域は、複数の 256 KB ビューにまたがることはできません。 したがって、ピン留めできる最大の領域は 256 KB で、ファイル内の 256 KB で整列されたオフセットから始められます。

キャッシュされたファイルにバイト範囲をピン留めしても、ページがメモリに常駐し続けるわけではありません。 ページがピン留めされている限り、バイト範囲はシステム キャッシュの仮想アドレス空間にマップされたままであることが保証されますが、メモリ マネージャーは、システムのメモリ要求に応じて物理ページをページングできます。

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

キャッシュされたファイルのデータをマップするには、CcMapData ルーチンを使用します。 ファイルをキャッシュするには、ccInitializeCacheMap使用します。

CcPinMappedData を呼び出した後、ccUnpinData を呼び出す必要はありません。これは、ピン参照が ccMapData照合されるためです。

必要条件

関連項目

ccInitializeCacheMap の

CcMapData を する

CcPinRead

ccPreparePinWrite を する

ccSetDirtyPinnedData の

ccUnpinData を する