FltGetVolumeFromInstance 関数 (fltkernel.h)
FltGetVolumeFromInstance ルーチンは、特定のミニフィルター ドライバー インスタンスがアタッチされているボリュームの不透明なポインターを返します。
構文
NTSTATUS FLTAPI FltGetVolumeFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_VOLUME *RetVolume
);
パラメーター
[in] Instance
インスタンスの不透明なインスタンス ポインター。
[out] RetVolume
ボリュームの不透明なポインターを受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは必須であり、NULL することはできません。
戻り値
FltGetVolumeFromInstance は、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。
| リターン コード | 形容 |
|---|---|
|
ミニフィルター ドライバー インスタンスがアタッチされているボリュームが切断されています。 これはエラー コードです。 |
備考
FltGetVolumeFromInstance 、RetVolume パラメーターで返される不透明なボリューム ポインターへのランダウン参照を追加します。 このポインターが不要になったら、呼び出し元は FltObjectDereference 呼び出してポインターを解放する必要があります。 したがって、FltGetVolumeFromInstance の呼び出しが成功するたびに、FltObjectDereference への後続の呼び出し照合する必要があります。
特定のインスタンスを作成したミニフィルター ドライバーの不透明なフィルター ポインターを取得するには、FltGetFilterFromInstance 呼び出します。
特定のボリュームのデバイス オブジェクトへのポインターを取得するには、FltGetDeviceObject 呼び出します。
特定のインスタンスがアタッチされているボリュームに関する詳細情報を取得するには、FltQueryVolumeInformation 呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fltkernel.h (Fltkernel.h を含む) |
| ライブラリ | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
関連項目
FltGetDeviceObject の
FltGetFilterFromInstance の
FltQueryVolumeInformation の