次の方法で共有


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 値を返します。

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

備考

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

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 SP4 更新プログラムのロールアップ。Windows XP
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer の

FsRtlInitPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSetupAdvancedHeader の

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts