VDS_VOLUME_PROP2構造体 (vds.h)

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

[Windows 8とWindows Server 2012以降、仮想ディスクサービス COM インターフェイスは Windows Storage Management API に置き換えられます。

ボリュームオブジェクトのプロパティを定義します。この構造体は、ボリューム GUID も含まれている点を除き、VDS_VOLUME_PROP構造体と同じです。

構文

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

メンバー

id

ボリュームの GUID。

type

ボリュームの種類を指定する VDS_VOLUME_TYPE 列挙値。ボリュームの種類は、シンプル、スパン、ストライプ (RAID-0)、ミラー化、またはパリティ付きストライプ (RAID-5) です。

status

ボリュームの状態を指定する VDS_VOLUME_STATUS 列挙値。

health

ボリュームの正常性状態を指定するVDS_HEALTH列挙値。

TransitionState

ボリュームの遷移状態を指定するVDS_TRANSITION_STATE列挙値。

ullSize

ボリュームのサイズ (バイト単位)。

ulFlags

ボリュームを記述 VDS_VOLUME_FLAG 列挙値のビットマスク。

RecommendedFileSystemType

ボリュームの優先ファイルシステムを指定するVDS_FILE_SYSTEM_TYPE列挙値。 VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、VDS_FST_UDF、VDS_FST_CDFS、VDS_FST_UNKNOWNのいずれかである必要があります。

cbUniqueId

pUniqueId メンバーが指すバイト配列の長さ。

pwszName

CreateFile 関数を使用してボリュームのハンドルを開くために使用された名前。たとえば、\?\GLOBALROOT\Device\HarddiskVolume1 などです。

pUniqueId

ボリュームの一意識別子を含むバイト配列。

注釈

IVdsVolume2::GetProperties2 メソッドは、ボリュームオブジェクトのプロパティを報告するためにこの構造体を返します。

ボリュームがオフラインの場合、 VDS_VOLUME_PROP2 構造体の ulFlags メンバーに VDS_VF_PERMANENTLY_DISMOUNTED フラグが設定され、 VDS_VS_OFFLINE ボリュームの状態値もこの構造体の状態メンバーに設定されます。

GPT および動的ボリュームの場合、 pUniqueId メンバーが指す一意識別子はグローバルに一意です。

リムーバブルメディアドライブの場合、ボリュームは存在し、デバイスにメディアがない場合でも独自の一意識別子を持ちます。ボリュームがリムーバブルメディアでフォーマットされている場合、そのボリュームには独自の一意識別子があります。詳細については、「記憶域クラスドライバーでのマウントマネージャー要求のサポート」を参照してください。

一意識別子の形式は、デバイスとボリュームの種類によって異なる場合があります。 MBR ディスク上のベーシックボリュームの場合、一意の識別子はディスク署名とパーティションオフセットに基づきます。ディスク署名とパーティションオフセットは DWORD 値であるため、一意の識別子がコンピューター間でグローバルに一意であるとは限りません。

ディスク署名が変更されると、ボリュームの一意識別子も変更されます。ディスク署名の変更は、通常、ディスクの複製中に競合が発生した結果として発生します。

一意識別子はボリューム GUID パスと同じではないことに注意してください。ボリュームのボリューム GUID パスを見つけるには、 IVdsVolumeMF3::QueryVolumeGuidPathnames メソッドを使用します。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	vds.h