共用方式為


VDS_DISK_PROP 結構 (vds.h)

[從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

如果 PartitionStyleVDS_PST_MBR ( 1) ,則會使用 。 MBR 磁碟分區的簽章。 此值不保證是唯一的。

DiskGuid

如果 PartitionStyleVDS_PST_GPT ( 2) ,則會使用 。 磁片的 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

隨插即用 Manager 所傳回的名稱。 此名稱會由隨插即用管理員在 Windows 登錄中維護,例如:「SEAGATE ST34573N SCSI 磁片裝置」。

pwszAdaptorName

此磁片所連接的介面卡名稱。 隨插即用管理員會傳回在 Windows 登錄中維護的名稱,例如:「Adaptec AHA-2940U2W - Ultra2 SCSI」。

pwszDevicePath

隨插即用 Manager 所傳回的字串。 隨插即用管理員會使用裝置路徑來唯一識別電腦上的裝置。 如需詳細資訊,請參閱 SP_DEVICE_INTERFACE_DETAIL_DATA_W

備註

IVdsDisk::GetProperties方法會傳回這個結構的值,以報告磁片物件的屬性。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 vds.h

另請參閱

IVdsDisk::GetProperties

VDS 結構

VDS_DISK_FLAG

VDS_DISK_PROP2

VDS_DISK_STATUS

VDS_HEALTH

VDS_PARTITION_INFO_GPT

VDS_PARTITION_INFO_MBR

VDS_PARTITION_STYLE

VDS_STORAGE_BUS_TYPE