VDS_DISK_PROP 結構 (vds.h)

發行項
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

如果 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