ZwSetVolumeInformationFile 関数 (ntifs.h)

[アーティクル]
02/29/2024

ZwSetVolumeInformationFile ルーチンは、特定のファイル、ディレクトリ、ストレージデバイス、またはボリュームに関連付けられているボリュームに関する情報を変更します。

構文

NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [in]  PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

パラメーター

[in] FileHandle

ボリューム情報を変更する開いているファイル、ディレクトリ、ストレージデバイス、またはボリュームのファイルオブジェクトを処理します。

[out] IoStatusBlock

最終的な完了状態と操作に関する情報を受け取るIO_STATUS_BLOCK構造体へのポインター。

[in] FsInformation

変更するボリューム情報を含む呼び出し元によって割り当てられたバッファーへのポインター。このバッファー内の情報の構造は、次の表に示すように、 FsInformationClass の値によって異なります。

[in] Length

FsInformation が指すバッファーのサイズ (バイト単位)。呼び出し元は、指定された FsInformationClass に従ってこのパラメーターを設定する必要があります。

[in] FsInformationClass

設定するボリューム情報の種類。次のいずれかになります。

値	意味
FileFsControlInformation	ボリュームのFILE_FS_CONTROL_INFORMATION を設定します。
FileFsLabelInformation	ボリュームのFILE_FS_LABEL_INFORMATION を設定します。
FileFsObjectIdInformation	ボリュームのFILE_FS_OBJECTID_INFORMATION を設定します。

戻り値

ZwSetVolumeInformationFile は 、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_INFO_LENGTH_MISMATCH	Length に無効な値が指定されました。これはエラーコードです。
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile でプール割り当てエラーが発生しました。これはエラーコードです。
STATUS_INVALID_INFO_CLASS	FsInformationClass に無効な値が指定されました。これはエラーコードです。

注釈

ボリューム情報を照会するには、 ZwQueryVolumeInformationFile を呼び出します。

ファイルに関する情報を変更するには、 ZwSetVolumeInformationFile を呼び出します。

ミニフィルターでは、 ZwSetVolumeInformationFile の代わりに FltSetInformationFile を使用する必要があります。

メモZwSetVolumeInformationFile関数の呼び出しがユーザーモードで行われる場合は、"ZwSetVolumeInformationFile" ではなく"NtSetInformationFile" という名前を使用する必要があります。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なります。 ルーチンの NtXxx バージョンと ZwXxx バージョン間の関係の詳細については、「Using Nt and Zw Versions of the Native System Services Routines」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2003
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)