(vdshwprv.h) VDS_DRIVE_PROP2 结构

项目
03/13/2024

[从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_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 表示未为驱动器定义此数字。由于某些机箱编号方案是从零开始的，因此零是此成员的有效值。此成员对应于 IVdsSubSystem2：：GetDrive2 方法的 ulEnclosureNumber 参数。

busType

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

ulSpindleSpeed

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

注解

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

要求

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

通过