структура VDS_DRIVE_PROP2 (vds.h)

Статья
03/03/2024

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Определяет свойства объекта drive. Эта структура идентична структуре 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 объекта drive.

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

Номер шины, к которой подключен диск. Это число является назначаемое реализацией значение, которое однозначно идентифицирует шину в подсистеме. Она не ограничивается количеством шин, содержащихся в подсистеме, и не связана со значением члена sNumberOfInternalBusesструктуры VDS_SUB_SYSTEM_PROP .

sSlotNumber

Номер слота, занимаемого диском. Это число является назначаемое реализацией значение, которое однозначно идентифицирует слот в шине. Он не ограничивается количеством слотов, содержащихся в шине, и не связан со значением члена sMaxNumberOfSlotsEachBusструктуры VDS_SUB_SYSTEM_PROP .

ulEnclosureNumber

Номер корпуса, содержащего диск. Значение ULONG_MAX указывает, что это число не определено для диска. Так как некоторые схемы нумеровки корпусов основаны на нулях, ноль является допустимым значением для этого элемента. Этот элемент соответствует параметру ulEnclosureNumber метода IVdsSubSystem2::GetDrive2 .

busType

Значение VDS_STORAGE_BUS_TYPE , указывающее тип шины диска. Нулевое значение означает, что тип шины неизвестен.

ulSpindleSpeed

Скорость шпинделя диска в rpm. Значение по умолчанию для этого элемента равно нулю. Нулевое значение означает, что скорость шпинделя неизвестна. Значение 1 означает, что диск не имеет вращающегося носителя. (Например, это может быть твердотельный накопитель.)

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	vds.h