FltSetStreamContext 関数 (fltkernel.h)
FltSetStreamContext ルーチンは、ファイル ストリームのコンテキストを設定します。
構文
NTSTATUS FLTAPI FltSetStreamContext(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[in] FLT_SET_CONTEXT_OPERATION Operation,
[in] PFLT_CONTEXT NewContext,
[out] PFLT_CONTEXT *OldContext
);
パラメーター
[in] Instance
ファイル ストリームにアタッチされているコンテキストの一覧にコンテキストを挿入、削除、または置き換えるミニフィルター ドライバー インスタンスの不透明なインスタンス ポインター。
[in] FileObject
ファイル ストリームの ファイル オブジェクトへのポインター。
[in] Operation
実行する操作の詳細を指定するフラグ。 このパラメーターは、次のいずれかである必要があります。
旗 | 意味 |
---|---|
FLT_SET_CONTEXT_REPLACE_IF_EXISTS | インスタンスにコンテキストが既に設定されている場合、FltSetStreamContext は、NewContext で指定されたコンテキスト置き換えられます。 それ以外の場合は、NewContext をファイル ストリームのコンテキストの一覧に挿入します。 |
FLT_SET_CONTEXT_KEEP_IF_EXISTS | この インスタンスに対してコンテキストが既に設定されている場合、FltSetStreamContext はSTATUS_FLT_CONTEXT_ALREADY_DEFINEDを返し、既存のコンテキストを置き換えたり、参照カウントをインクリメントしたりしません。 コンテキストがまだ設定されていない場合、ルーチンは NewContext をファイル ストリームのコンテキストの一覧に挿入し、参照カウントをインクリメントします。 |
[in] NewContext
ファイル ストリームに設定する新しいコンテキストへのポインター。 このパラメーターは必須であり、NULL することはできません。
[out] OldContext
Instance パラメーターの既存のストリーム コンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター (既に設定されている場合)。 このパラメーターは省略可能であり、NULL できます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。
戻り値
FltSetStreamContext ルーチンは、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。
リターン コード | 形容 |
---|---|
STATUS_FLT_CONTEXT_ALREADY_DEFINED | 操作にFLT_SET_CONTEXT_KEEP_IF_EXISTSが指定されている場合、このエラー コードは、ストリーム コンテキストが既にファイル ストリームにアタッチされていることを示します。 |
STATUS_FLT_CONTEXT_ALREADY_LINKED | NewContext パラメーターが指すコンテキストは、既にオブジェクトにリンクされています。 言い換えると、このエラー コードは、NewContext が既に使用されていることを示しています。これは、FltSetXxxContext ルーチンが正常に呼び出されたためです。 |
STATUS_FLT_DELETING_OBJECT | Instance パラメーターで指定されたインスタンスが切断されています。 これはエラー コードです。 |
STATUS_INVALID_PARAMETER | 無効なパラメーターが渡されました。 たとえば、NewContext パラメーターが有効なストリーム コンテキストを指していないか、Operation パラメーターに無効な値が指定されています。 これはエラー コードです。 |
STATUS_NOT_SUPPORTED | ファイル システムは、このファイル ストリームのストリームごとのコンテキストをサポートしていません。 これはエラー コードです。 |
備考
コンテキストの詳細については、「ミニフィルター コンテキストについて」を参照してください。
ミニフィルター ドライバーは、FltSetStreamContext 呼び出して、ストリーム コンテキストをファイル ストリームにアタッチするか、既存のストリーム コンテキストを削除または置換します。 ミニフィルター ドライバーは、ミニフィルター ドライバー インスタンスごとに 1 つのコンテキストをファイル ストリームにアタッチできます。
開いていない FileObjectで FltSetStreamContext を呼び出すことはできません。 そのため、ストリームの事前作成コールバックから呼び出すことはできません。これは、ストリームがその時点で開かされていないためです。 ただし、ミニフィルター ドライバーは、事前作成コールバックでストリーム コンテキストを割り当てて設定し、完了コンテキスト パラメーターを使用して作成後コールバックに渡し、作成後のコールバックでストリームのストリーム コンテキストを設定できます。
参照カウント
FltSetStreamContext 成功した場合:
- NewContext の参照カウントがインクリメントされます。 NewContext 不要になった場合、ミニフィルターは FltReleaseContext呼び出して参照カウントを減らす必要があります。
FltSetStreamContext 失敗した場合は、次のようになります。
- NewContext の参照カウントは変更されません。
- OldContext が NULL ではなく、NULL_CONTEXTを指していない場合、OldContext は、現在ストリームに関連付けられているコンテキストへの参照ポインターです。 FltSetStreamContext 呼び出すフィルターは、コンテキスト ポインターが不要になった場合 、OldContext の FltReleaseContext を呼び出す必要があります。
成功に関係なく:
- FltSetStreamContext 呼び出すフィルターは、FltReleaseContext呼び出して、FltAllocateContextによってインクリメントされた NewContext オブジェクトの参照カウント減らす必要があります。
詳細については、「コンテキストの参照」を参照してください。
その他のコンテキスト操作
詳細については、「コンテキストの設定」および「コンテキストの解放」を参照してください。
特定のファイルに対してストリーム コンテキストがサポートされているかどうかを確認するには、FltSupportsStreamContexts 呼び出
ストリーム コンテキストを削除するには、FltDeleteStreamContext呼び出すか、FltDeleteContextをします。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Microsoft Windows 2000 Update Rollup 1 for SP4、Windows XP SP2、Windows Server 2003 SP1、およびそれ以降のオペレーティング システムで使用可能でサポートされています。 |
ターゲット プラットフォーム の | 万国 |
ヘッダー | fltkernel.h (Fltkernel.h を含む) |
ライブラリ | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
関連項目
FltAllocateContextの
FltDeleteContextの
FltDeleteStreamContextの
FltGetStreamContextの
FltReleaseContextの