VDS_DRIVE_PROP2結構 (vdshwprv.h)

發行項
03/09/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

共用方式為