FltSetVolumeContext 関数 (fltkernel.h)
FltSetVolumeContext 、ボリュームのコンテキストを設定します。
構文
NTSTATUS FLTAPI FltSetVolumeContext(
[in] PFLT_VOLUME Volume,
[in] FLT_SET_CONTEXT_OPERATION Operation,
[in] PFLT_CONTEXT NewContext,
[out, optional] PFLT_CONTEXT *OldContext
);
パラメーター
[in] Volume
ボリュームの不透明なボリューム ポインター。
[in] Operation
実行する操作の詳細を指定するフラグ。 このパラメーターは、次のいずれかである必要があります。
旗 | 意味 |
---|---|
FLT_SET_CONTEXT_REPLACE_IF_EXISTS | ボリュームにコンテキストが既に設定されている場合は、FltSetVolumeContext を NewContext >置き換えます。 それ以外の場合は、NewContext をボリュームのコンテキストの一覧に挿入します。 |
FLT_SET_CONTEXT_KEEP_IF_EXISTS | このボリュームに対してコンテキストが既に設定されている場合、FltSetVolumeContext はSTATUS_FLT_CONTEXT_ALREADY_DEFINEDを返し、既存のコンテキストを置き換えたり、参照カウントをインクリメントしたりしません。 コンテキストがまだ設定されていない場合、ルーチンは NewContext をボリュームのコンテキストの一覧に挿入し、参照カウントをインクリメントします。 |
[in] NewContext
ボリュームに設定する新しいコンテキストへのポインター。 このパラメーターは必須であり、NULL することはできません。
[out, optional] OldContext
ボリュームの既存のボリューム コンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、NULL できます。 このパラメーターの詳細については、次の「解説」セクションを参照してください。
戻り値
FltSetVolumeContext は、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 | 指定された ボリューム が切断されています。 これはエラー コードです。 |
STATUS_INVALID_PARAMETER | 無効なパラメーターが渡されました。 たとえば、NewContext パラメーターが有効なボリューム コンテキストを指していないか、Operationに無効な値が指定されました。 これはエラー コードです。 |
備考
コンテキストの詳細については、「ミニフィルター コンテキストについて」を参照してください。
ミニフィルター ドライバーは、FltSetVolumeContext 呼び出して、コンテキストをボリュームにアタッチしたり、既存のボリューム コンテキストを削除または置換したりします。 ミニフィルター ドライバーは、ボリュームに 1 つのコンテキストのみをアタッチできます。
参照カウント
FltSetVolumeContext 成功した場合:
- NewContext の参照カウントがインクリメントされます。 NewContext 不要になった場合、ミニフィルターは FltReleaseContext呼び出して参照カウントを減らす必要があります。
FltSetVolumeContext 失敗した場合は、次のようになります。
- NewContext の参照カウントは変更されません。
- OldContext が NULL されておらず、NULL_CONTEXTを指していない場合、OldContext は、現在ボリュームに関連付けられているコンテキストへの参照ポインターです。 FltSetVolumeContext 呼び出すフィルターは、コンテキスト ポインターが不要になった場合 、OldContext に対して FltReleaseContext を呼び出す必要があります。
成功に関係なく:
- FltSetVolumeContext 呼び出すフィルターは、FltReleaseContext呼び出して、FltAllocateContextによってインクリメントされた NewContext オブジェクト参照カウントを減らす必要があります。
詳細については、「コンテキストの参照」を参照してください。
その他のコンテキスト操作
詳細については、「コンテキストの設定」および「コンテキストの解放」を参照してください。
ボリューム コンテキストを削除するには、FltDeleteVolumeContext呼び出すか、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の
FltDeleteVolumeContextをする
FltGetVolumeContextの
FltReleaseContextの