VDS_DRIVE_PROP2 構造体 (vdshwprv.h)

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

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

ドライブオブジェクトのプロパティを定義します。この構造は、エンクロージャ番号、バスタイプ、スピンドル速度をメンバーとして含む点を除き、VDS_DRIVE_PROP構造と同じです。

構文

typedef struct _VDS_DRIVE_PROP2 {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  ULONG                ulFlags;
  VDS_DRIVE_STATUS     status;
  VDS_HEALTH           health;
  SHORT                sInternalBusNumber;
  SHORT                sSlotNumber;
  ULONG                ulEnclosureNumber;
  VDS_STORAGE_BUS_TYPE busType;
  ULONG                ulSpindleSpeed;
} VDS_DRIVE_PROP2, *PVDS_DRIVE_PROP2;

メンバー

id

ドライブオブジェクトの GUID。

ullSize

ドライブのサイズ (バイト単位)。

pwszFriendlyName

ドライブの名前を含む NULL で終わるワイド文字列。

pwszIdentification

ドライブ識別子を含む NULL で終わるワイド文字列。

ulFlags

のビットマスク
列挙値をVDS_DRIVE_FLAGします。

status

A
VDS_DRIVE_STATUS ドライブの状態を指定する列挙値です。

health

ドライブの正常性状態を指定するVDS_HEALTH列挙値。このメンバーの有効な値を次に示します。

Windows Server 2008、Windows Vista、Windows Server 2003: VDS_H_REPLACED と VDS_H_PENDING_FAILURE はサポートされていません。

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILED (8)

VDS_H_REPLACED (9)

VDS_H_PENDING_FAILURE (10)

sInternalBusNumber

ドライブが接続されているバスの番号。この数値は、サブシステム内のバスを一意に識別する実装者割り当て値です。サブシステムに含まれるバスの数によって制限されず、VDS_SUB_SYSTEM_PROP構造体の sNumberOfInternalBuses メンバーの値には関係ありません。

sSlotNumber

ドライブが占有するスロットの番号。この数値は、バス内のスロットを一意に識別する実装者割り当て値です。バスに含まれるスロットの数によって制限されず、VDS_SUB_SYSTEM_PROP構造体の sMaxNumberOfSlotsEachBus メンバーの値には関係ありません。

ulEnclosureNumber

ドライブを含むエンクロージャの番号。 ULONG_MAXの値は、この数値がドライブに対して定義されていないことを示します。一部のエンクロージャ番号付けスキームは 0 から始まるため、0 はこのメンバーの有効な値です。このメンバーは、IVdsSubSystem2::GetDrive2 メソッドの ulEnclosureNumber パラメーターに対応します。

busType

ドライブのバスの種類を指定するVDS_STORAGE_BUS_TYPE値。値 0 は、バスの種類が不明であることを意味します。

ulSpindleSpeed

RPM でのドライブのスピンドル速度。このメンバーの既定値は 0 です。 0 の値は、スピンドル速度が不明であることを意味します。値 1 は、ドライブに回転メディアがないことを意味します。 (たとえば、ソリッドステートドライブである可能性があります)。

注釈

この構造体は、ドライブオブジェクトのプロパティを返すために IVdsDrive2::GetProperties2 メソッドによって使用されます。

要件

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

次の方法で共有