FsRtlInsertPerStreamContext 関数 (ntifs.h)

[アーティクル]
03/08/2023

FsRtlInsertPerStreamContext ルーチンは、ファイルシステムフィルタードライバーのストリームごとのコンテキスト構造をファイルストリームに関連付けます。

構文

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

パラメーター

PerStreamContext

ファイルストリームのFSRTL_ADVANCED_FCB_HEADER構造体へのポインター。ファイルオブジェクトからこのポインターを取得するには、 FsRtlGetPerStreamContextPointer マクロを使用します。

[in] Ptr

フィルタードライバーが割り当て、初期化したFSRTL_PER_STREAM_CONTEXT構造体へのポインター。この構造体を初期化するには、 FsRtlInitPerStreamContext マクロを使用します。

戻り値

FsRtlInsertPerStreamContext は 、次のいずれかの NTSTATUS 値を返します。

リターンコード	説明
STATUS_SUCCESS	FsRtlInsertPerStreamContext の呼び出しが成功しました。
STATUS_INVALID_DEVICE_REQUEST	基になるファイルシステムでは、フィルターコンテキストはサポートされていません。

注釈

ファイルシステムフィルタードライバーは 、FsRtlInsertPerStreamContext を呼び出して、独自のストリームごとのコンテキスト構造をファイルストリームに関連付けます。ストリームごとのコンテキスト構造には、フィルタードライバーがファイルストリームに対して保持するコンテキスト情報が含まれています。

ストリームごとのコンテキスト構造がファイルストリームに関連付けられた後、 FsRtlLookupPerStreamContext を呼び出すことによって取得するか、 FsRtlRemovePerStreamContext を呼び出して削除できます。

詳細については、「レガシファイルシステムフィルタードライバーでの Per-Stream コンテキストの追跡」を参照してください。

要件

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