(vdshwprv.h) VDS_DRIVE_PROP2 结构

[从Windows 8和Windows Server 2012开始,虚拟磁盘服务 COM 接口由 Windows 存储管理 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_REPLACEDVDS_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 表示未为驱动器定义此数字。 由于某些机箱编号方案是从零开始的,因此零是此成员的有效值。 此成员对应于 IVdsSubSystem2::GetDrive2 方法的 ulEnclosureNumber 参数。

busType

一个VDS_STORAGE_BUS_TYPE值,该值指定驱动器的总线类型。 如果值为零,则表示总线类型未知。

ulSpindleSpeed

驱动器的主轴速度(以 RPM 为单位)。 此成员的默认值为零。 值为零表示主轴速度未知。 值为 1 表示驱动器没有旋转介质。 (例如,它可能是固态驱动器。)

注解

IVdsDrive2::GetProperties2 方法使用此结构返回驱动器对象的属性。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 vdshwprv.h