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

Статья
03/08/2023

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

Определяет свойства объекта диска.

Синтаксис

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_DS_ONLINE, даже если состояние содержащего пакета VDS_PS_OFFLINE.

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 имеет значение VDS_PST_GPT (2). Идентификатор GUID для диска. Кроме того, у каждой секции GPT есть собственный GUID. (См . VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

Адрес диска, подобного SCSI, в форматеNNNPathNNNTargetNNN Lun NNN, где NNN — это одна или несколько цифр.

Диски SCSI, диски интегрированной среды разработки и диски Fibre Channel могут иметь такой адрес. Диски USB и 1394 имеют разные форматы адресов и не сохраняются.

Этот член является необязательным и может иметь значение NULL , если значение недоступно. Если значение не равно NULL, его длина должна быть больше или равна 22 WCHAR и меньше или равна 64 WCHAR, включая обязательный признак конца NULL . Приложения, получающие структуру VDS_DISK_PROP путем вызова IVdsDisk::GetProperties , должны проверять, имеет ли этот член значение NULL.

pwszName

Имя, используемое для открытия дескриптора для объекта, созданного с помощью функции CreateFile . Пример: \\?\PhysicalDrive2

pwszFriendlyName

Имя, возвращаемое диспетчером Plug and Play. Это имя сохраняется в реестре Windows Plug and Play Manager, например SEAGATE ST34573N SCSI Disk Device.

pwszAdaptorName

Имя адаптера, к которому подключен этот диск. Диспетчер Plug and Play возвращает имя, которое хранится в реестре Windows, например"Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

Строка, возвращаемая диспетчером Plug and Play. Диспетчер Plug and Play использует путь к устройству для уникальной идентификации устройства на компьютере. Дополнительные сведения см. в разделе SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	vds.h