FsRtlInsertPerStreamContext 関数 (ntifs.h)
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 値を返します。
| リターン コード | 説明 |
|---|---|
|
FsRtlInsertPerStreamContext の呼び出しが成功しました。 |
|
基になるファイル システムでは、フィルター コンテキストはサポートされていません。 |
注釈
ファイル システム フィルター ドライバーは 、FsRtlInsertPerStreamContext を呼び出して、独自のストリームごとのコンテキスト構造をファイル ストリームに関連付けます。 ストリームごとのコンテキスト構造には、フィルター ドライバーがファイル ストリームに対して保持するコンテキスト情報が含まれています。
ストリームごとのコンテキスト構造がファイル ストリームに関連付けられた後、 FsRtlLookupPerStreamContext を呼び出すことによって取得するか、 FsRtlRemovePerStreamContext を呼び出して削除できます。
詳細については、「 レガシ ファイル システム フィルター ドライバーでの Per-Stream コンテキストの追跡」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 SP4 更新プログラムのロールアップ。Windows XP |
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
こちらもご覧ください
FsRtlGetPerStreamContextPointer