FLT_VOLUME_PROPERTIES 構造体 (fltkernel.h)

[アーティクル]
03/05/2024

FLT_VOLUME_PROPERTIES構造体は、 FltGetVolumeProperties にパラメーターとして渡されます。

構文

typedef struct _FLT_VOLUME_PROPERTIES {
  DEVICE_TYPE    DeviceType;
  ULONG          DeviceCharacteristics;
  ULONG          DeviceObjectFlags;
  ULONG          AlignmentRequirement;
  USHORT         SectorSize;
  USHORT         Flags;
  UNICODE_STRING FileSystemDriverName;
  UNICODE_STRING FileSystemDeviceName;
  UNICODE_STRING RealDeviceName;
} FLT_VOLUME_PROPERTIES, *PFLT_VOLUME_PROPERTIES;

メンバー

DeviceType

ボリュームのデバイスの種類を受け取ります。 ntifs.h で定義されている次のいずれかの値など、有効なストレージデバイスの種類である必要があります。

FILE_DEVICE_CD_ROM

FILE_DEVICE_DISK

FILE_DEVICE_DVD

FILE_DEVICE_MASS_STORAGE

FILE_DEVICE_NETWORK

FILE_DEVICE_VIRTUAL_DISK

詳細については、「デバイスの種類の指定」を参照してください。

DeviceCharacteristics

ボリュームのデバイス特性を受け取ります。詳細については、 IoCreateDevice のリファレンスエントリを参照してください。

DeviceObjectFlags

ボリュームのデバイスオブジェクトフラグを受け取ります。これらのフラグの詳細については、 IoRegisterFileSystem と DEVICE_OBJECTのリファレンスエントリを参照してください。

AlignmentRequirement

基になるデバイスに必要なバッファーアラインメントを受け取ります。値は、ntifs.h で定義されているFILE_xxxx_ALIGNMENT値のいずれかである必要があります。詳細については、「デバイスオブジェクトのDEVICE_OBJECTと初期化」を参照してください。

SectorSize

ボリュームセクターサイズをバイト単位で受け取ります。

Flags

ボリュームの追加の説明を提供します。このメンバーには、0 または次のいずれかのフラグを指定できます。 Windows 10 バージョン 1607 より前のバージョンでは、このメンバーの名前は Reserved0 で、システム使用用に予約されていました。

値	意味
VOL_PROP_FL_DAX_VOLUME	このフラグは、ボリュームが直接アクセス (DAX) ボリュームであることを示します。

FileSystemDriverName

UNICODE_STRING このボリュームにマウントされているファイルシステムのサービス名を受け取る構造体です。この Unicode 文字列のバッファーは、この構造体と連続しており、 FltGetVolumeProperties を呼び出す前に初期化する必要はありません。

FileSystemDeviceName

UNICODE_STRINGこのボリュームに関連付けられているファイルシステムデバイスオブジェクトの名前を受け取る構造体です。この Unicode 文字列のバッファーは、この構造体と連続しており、 FltGetVolumeProperties を呼び出す前に初期化する必要はありません。

RealDeviceName

UNICODE_STRING、このボリュームに関連付けられているストレージデバイスオブジェクトの名前を受け取る構造体です。ネットワークファイルシステムの場合、この構造は空です。この Unicode 文字列のバッファーは、この構造体と連続しており、 FltGetVolumeProperties を呼び出す前に初期化する必要はありません。