FltSetVolumeInformation 関数 (fltkernel.h)
FltSetVolumeInformation 、指定されたインスタンスがアタッチされているボリュームに関するさまざまな種類の情報を変更します。
構文
NTSTATUS FLTAPI FltSetVolumeInformation(
[in] PFLT_INSTANCE Instance,
[out] PIO_STATUS_BLOCK Iosb,
[out] PVOID FsInformation,
[in] ULONG Length,
[in] FS_INFORMATION_CLASS FsInformationClass
);
パラメーター
[in] Instance
ボリュームにアタッチされているミニフィルター ドライバー インスタンスの不透明なインスタンス ポインター。
[out] Iosb
最終的な完了状態と操作に関する情報を受け取るIO_STATUS_BLOCK構造体へのポインター。
[out] FsInformation
ボリュームに設定する値を含む呼び出し元によって割り当てられたバッファーへのポインター。 バッファーに含まれる情報の構造は、FsInformationClass パラメーターによって定義されます。
[in] Length
FsInformation が指 バッファーのサイズ (バイト単位)。 呼び出し元は、指定された FsInformationClassに従ってこのパラメーターを設定する必要があります。 たとえば、FsInformationClass の値が FileFsControlInformation の場合、Length は、sizeof(FILE_FS_CONTROL_INFORMATION) 以上である必要があります。
[in] FsInformationClass
ボリュームに設定する情報の種類。 次のいずれか。
| 価値 | 意味 |
|---|---|
| FileFsControlInformation の | ボリュームの FILE_FS_CONTROL_INFORMATION を設定します。 |
| FileFsLabelInformation | ボリュームの FILE_FS_LABEL_INFORMATION を設定します。 |
| FileFsObjectIdInformation の | ボリュームの FILE_FS_OBJECTID_INFORMATION を設定します。 |
戻り値
FltSetVolumeInformation STATUS_SUCCESSまたは次のいずれかの適切な NTSTATUS 値を返します。
| リターン コード | 形容 |
|---|---|
|
Lengthに無効な値が指定されました。 これはエラー コードです。 |
|
FltSetVolumeInformation プール割り当てエラーが発生しました。 これはエラー コードです。 |
|
FsInformationClassに無効な値が指定されました。 これはエラー コードです。 |
|
インスタンス は、ネットワーク ボリュームに接続されます。 FltSetVolumeInformation を使用してネットワーク ボリューム情報を設定することはできません。 これはエラー コードです。 |
備考
ボリュームに関する情報を照会するには、FltQueryVolumeInformation 呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fltkernel.h (Fltkernel.h を含む) |
| ライブラリ | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |
関連項目
FltQueryVolumeInformation の