(vds.h) VDS_DISK_PROP 结构

项目
03/08/2023

[从Windows 8和Windows Server 2012开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

语法

typedef struct _VDS_DISK_PROP {
  VDS_OBJECT_ID        id;
  VDS_DISK_STATUS      status;
  VDS_LUN_RESERVE_MODE ReserveMode;
  VDS_HEALTH           health;
  DWORD                dwDeviceType;
  DWORD                dwMediaType;
  ULONGLONG            ullSize;
  ULONG                ulBytesPerSector;
  ULONG                ulSectorsPerTrack;
  ULONG                ulTracksPerCylinder;
  ULONG                ulFlags;
  VDS_STORAGE_BUS_TYPE BusType;
  VDS_PARTITION_STYLE  PartitionStyle;
  union {
    DWORD dwSignature;
    GUID  DiskGuid;
  };
  LPWSTR               pwszDiskAddress;
  LPWSTR               pwszName;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszAdaptorName;
  LPWSTR               pwszDevicePath;
} VDS_DISK_PROP, *PVDS_DISK_PROP;

成员

id

磁盘对象的 GUID。

status

VDS_DISK_STATUS 枚举的物理磁盘的可用性。如果 VDS 服务无法打开磁盘的句柄，则会将此成员设置为 VDS_DS_UNKNOWN。

注意即使包含包的状态VDS_PS_OFFLINE，也可以VDS_DS_ONLINE此成员。

ReserveMode

此成员留待将来使用。

health

一个VDS_HEALTH枚举值，该值指定磁盘的运行状况状态。下面是此成员的有效值。

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

Winioctl.h 中定义的设备类型，其中包括以下类型等：

dwMediaType

由 STORAGE_MEDIA_TYPE 枚举的媒体类型。基本磁盘和动态磁盘映射到 FixedMedia 枚举器。有关详细信息，请参阅 STORAGE_MEDIA_TYPE。

ullSize

磁盘的大小（以字节为单位）。若要确定磁盘的最大卷大小，请调用 IVdsDisk3：：QueryFreeExtents 并添加所有可用盘区的大小。

ulBytesPerSector

每个扇区中的字节数。

ulSectorsPerTrack

每个轨道中的扇区数。

ulTracksPerCylinder

每个柱形中的轨道数。

ulFlags

指定各种磁盘属性的VDS_DISK_FLAG 枚举值的位掩码。

BusType

VDS_STORAGE_BUS_TYPE枚举的输入/输出总线类型。

PartitionStyle

一个VDS_PARTITION_STYLE枚举值，该值指定分区类型。这个成员是工会的歧视者。

dwSignature

如果 PartitionStyle为 VDS_PST_MBR ( 1) ，则使用。 MBR 分区的签名。此值不保证是唯一的。

DiskGuid

如果 PartitionStyle (2 ) VDS_PST_GPT，则使用。磁盘的 GUID。此外，每个 GPT 分区都有自己的 GUID。 (请参阅 VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

端口 NNN 路径NNN目标NNNLunNNN格式的类似 SCSI 的磁盘的地址，其中 NNN 是一个或多个数字。

SCSI 磁盘、IDE 磁盘和光纤通道磁盘可以有这样的地址。 USB 和 1394 磁盘具有不同的地址格式，不存储。

此成员是可选的，如果没有可用的值，可以为 NULL 。如果它不是 NULL，则其长度必须大于或等于 22 WCHAR，小于或等于 64 WCHAR，包括所需的 NULL 终止符。通过调用 IVdsDisk：：GetProperties 接收 VDS_DISK_PROP 结构的应用程序必须检查此成员是否为 NULL。

pwszName

用于打开使用 CreateFile 函数创建的对象的句柄的名称。例如： \\?\PhysicalDrive2

pwszFriendlyName

即插即用管理器返回的名称。此名称由即插即用管理器在 Windows 注册表中维护，例如：“SEAGATE ST34573N SCSI 磁盘设备”。

pwszAdaptorName

此磁盘所附加到的适配器的名称。即插即用管理器返回在 Windows 注册表中维护的名称，例如：“Adaptec AHA-2940U2W - Ultra2 SCSI”。

pwszDevicePath

即插即用管理器返回的字符串。即插即用管理器使用设备路径来唯一标识计算机上的设备。有关详细信息，请参阅 SP_DEVICE_INTERFACE_DETAIL_DATA_W。