NtQueryVolumeInformationFile 関数 (ntifs.h)

[アーティクル]
08/07/2023

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

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

パラメーター

[in] FileHandle

ボリューム情報が要求されている開いているファイル、ディレクトリ、ストレージデバイス、またはボリュームの NtCreateFile または NtOpenFile によって返されるファイルオブジェクトへのハンドル。

[out] IoStatusBlock

最終的 な完了 状態とクエリ操作に関する情報を受け取るIO_STATUS_BLOCK構造体へのポインター。データを返す呼び出しが成功した場合は、 FsInformation バッファーに書き込まれたバイト数が構造体の Information メンバーに返されます。

[out] FsInformation

ボリュームに関する必要な情報を受け取る呼び出し元によって割り当てられたバッファーへのポインター。バッファーで返される情報の構造は、 FsInformationClass パラメーターによって定義されます。

[in] Length

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

[in] FsInformationClass

ボリュームに関して返される情報の種類。このメンバーを次のいずれかのFS_INFORMATION_CLASS列挙値に設定します。

値	意味
FileFsAttributeInformation	ボリュームを担当するファイルシステムに関する属性情報を含む FILE_FS_ATTRIBUTE_INFORMATION 構造体を返します。
FileFsControlInformation	ボリュームに関するファイルシステム制御情報を含む FILE_FS_CONTROL_INFORMATION 構造体を返します。
FileFsDeviceInformation	ボリュームのデバイス情報を含む FILE_FS_DEVICE_INFORMATION 構造体を返します。
FileFsDriverPathInformation	指定したドライバーがボリュームの I/O パスにあるかどうかに関する情報を含むFILE_FS_DRIVER_PATH_INFORMATION構造体を返します。呼び出し元は、NtQueryVolumeInformationFile を呼び出す前に、ドライバーの名前を FILE_FS_DRIVER_PATH_INFORMATION 構造体に格納する必要があります。
FileFsFullSizeInformation	ボリュームで使用可能な領域の合計量に関する情報を含むFILE_FS_FULL_SIZE_INFORMATION構造体を返します。
FileFsObjectIdInformation	ボリュームのファイルシステム固有のオブジェクト ID 情報を含む FILE_FS_OBJECTID_INFORMATION 構造体を返します。これは、オペレーティングシステムによって割り当てられた (GUID ベースの) 一意のボリューム名と同じではないことに注意してください。
FileFsSizeInformation	呼び出し元スレッドに関連付けられているユーザーが使用できるボリューム上の領域の量に関する情報を含むFILE_FS_SIZE_INFORMATION構造体を返します。
FileFsVolumeInformation	ボリュームラベル、シリアル番号、作成時刻などのボリュームに関する情報を含む FILE_FS_VOLUME_INFORMATION を返します。
FileFsSectorSizeInformation	ボリュームの物理セクターサイズと論理セクターサイズに関する情報を含むFILE_FS_SECTOR_SIZE_INFORMATION構造体を返します。

戻り値

NtQueryVolumeInformationFile は 、STATUS_SUCCESSまたは適切なエラー状態を返します。

注釈

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

FileHandle が直接開いているデバイスを表す場合、FsInformationClass の値として指定できるのは FileFsDeviceInformation だけです。

NtQueryVolumeInformationFile は、ファイルシステムでサポートされていない FILE_XXX_INFORMATION 構造体のメンバーで 0 を返します。

その他のファイル情報クエリルーチンの詳細については、「ファイルオブジェクト」を参照してください。

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

NtQueryVolumeInformationFile の呼び出し元は、IRQL = PASSIVE_LEVELで実行され、特殊なカーネル APC が有効になっている必要があります。

注意

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

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

要件

要件	値
サポートされている最小のクライアント	Windows XP
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h、Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則	HwStorPortProhibitedDDIs、PowerIrpDDis