класс MSFT_Disk
Представляет диск Windows.
Объектная MSFT_Disk моделирует концепцию операционной системы Windows на диске. Диск может быть напрямую подключен к компьютерной системе или он может быть виртуальным диском, предоставляемым системе с помощью поставщика управления хранилищем.
Следующий синтаксис упрощен из кода формата управляемых объектов (MOF).
Синтаксис
class MSFT_Disk : MSFT_StorageObject
{
String Path;
String Location;
String FriendlyName;
String UniqueId;
UInt16 UniqueIdFormat;
UInt32 Number;
String SerialNumber;
String FirmwareVersion;
String Manufacturer;
String Model;
UInt64 Size;
UInt64 AllocatedSize;
UInt32 LogicalSectorSize;
UInt32 PhysicalSectorSize;
UInt64 LargestFreeExtent;
UInt32 NumberOfPartitions;
UInt16 ProvisioningType;
UInt16 OperationalStatus;
UInt16 HealthStatus;
UInt16 BusType;
UInt16 PartitionStyle;
UInt32 Signature;
String Guid;
Boolean IsOffline;
UInt16 OfflineReason;
Boolean IsReadOnly;
Boolean IsSystem;
Boolean IsClustered;
Boolean IsBoot;
Boolean BootFromDisk;
};
Участники
Класс MSFT_Disk имеет следующие типы элементов:
Методы
Класс MSFT_Disk имеет эти методы.
| Метод | Description |
|---|---|
| Clear | Удаляет сведения о секциях и неинициализирует диск, возвращая его в состояние RAW. |
| ConvertStyle | Преобразует стиль секции уже инициализированного диска. |
| CreatePartition | Создает секцию на диске. |
| Initialize | Инициализирует необработанный диск с определенным стилем секционирования. |
| Автономный режим | Принимает диск в автономном режиме. |
| В сети | Переносит диск в режим "в сети". |
| Обновить | Обновляет сведения о макете кэшированного диска. |
| SetAttributes | Задает атрибуты и свойства диска. |
Свойства
Класс MSFT_Disk имеет эти свойства.
Выделенный размер
Тип данных: UInt64
Тип доступа: только для чтения
Квалификаторы: обязательные, единицы (байты)
Объем пространства в байтах, который в настоящее время используется на диске.
BootFromDisk
Тип данных: Логический
Тип доступа: только для чтения
Значение TRUE , если компьютер настроен для запуска с этого диска. На компьютерах с встроенного ПО BIOS это первый диск, который обнаруживает встроенное ПО во время запуска. На компьютерах, использующих встроенное ПО EFI, это диск, содержащий системный раздел EFI (ESP). Если нет дисков или имеется несколько дисков с разделом ESP, это свойство не задано для любого диска.
BusType
Тип данных: UInt16
Тип доступа: только для чтения
Тип шины ввода-вывода, используемый диском.
| Значение | Значение |
|---|---|
| Неизвестно 0 | Тип шины неизвестен. |
| SCSI 1 | SCSI |
| ATAPI 2 | ATAPI |
| ATA 3 | ATA |
| 1394 4 | IEEE 1394 |
| SSA 5 | SSA |
| Fibre Channel 6 | Fibre Channel, |
| USB 7 | USB |
| RAID 8 | RAID |
| iSCSI 9 | iSCSI |
| SAS 10 | SCSI (SAS) с последовательным подключением. |
| SATA 11 | Serial ATA (SATA) |
| SD 12 | Secure Digital (SD) |
| MMC 13 | Мультимедийная карточка (MMC) |
| Виртуальная 14 | Это значение зарезервировано для использования системы. |
| Поддерживаемая файлом виртуальная версия 15 | Виртуальная поддержка файлов |
| дисковые пространства 16 | Дисковые пространства |
| NVMe 17 | NVMe |
Встроенное ПО
Тип данных: Строка
Тип доступа: только для чтения
Строковое представление версии встроенного ПО диска.
FriendlyName
Тип данных: Строка
Тип доступа: только для чтения
Квалификаторы: обязательный
Пользовательская, отображаемая строка для идентификации диска.
Guid
Тип данных: Строка
Тип доступа: только для чтения
Если partitionStyle имеет GPT, это свойство содержит GUID для диска. Это свойство будет иметь значение NULL для всех других типов дисков.
HealthStatus
Тип данных: UInt16
Тип доступа: только для чтения
Состояние работоспособности устройства диска.
| Значение | Значение |
|---|---|
| Работоспособное 0 | Диск работает нормально. |
| Предупреждение 1 | Диск по-прежнему работает, но обнаружил ошибки или проблемы, требующие вмешательства администратора. |
| Неработоспособная 2 | Том не работает из-за ошибок или сбоев. Тому требуется немедленное внимание от администратора. |
IsBoot
Тип данных: Логический
Тип доступа: только для чтения
Значение TRUE , если диск содержит загрузочный раздел.
IsClustered
Тип данных: Логический
Тип доступа: только для чтения
ЗНАЧЕНИЕ TRUE , если диск используется в кластеризованной среде или FALSE в противном случае.
IsOffline
Тип данных: Логический
Тип доступа: только для чтения
Значение TRUE , если диск находится в автономном режиме или false .
IsReadOnly
Тип данных: Логический
Тип доступа: только для чтения
ЗНАЧЕНИЕ TRUE , если диск доступен только для чтения, или значение FALSE , если оно доступно для чтения и записи.
IsSystem
Тип данных: Логический
Тип доступа: только для чтения
ЗНАЧЕНИЕ TRUE , если этот диск содержит системную секцию или значение FALSE .
LargestFreeExtent
Тип данных: UInt64
Тип доступа: только для чтения
Квалификаторы: единицы (байты)
Самый большой смежный блок свободного места на диске. Это также самый большой размер секции, которую можно создать на диске.
Местонахождение
Тип данных: Строка
Тип доступа: только для чтения
Строка, содержащая путь к расположению PnP диска. Формат этой строки зависит от типа шины. Если тип шины — SCSI, SAS или PCI RAID, формат — AdapterPnpLocationPath#BusType(PPathId TTargetIdLLunId). Если тип шины — IDE, ATA, PATA или SATA, формат — AdapterPnpLocationPath#BusType(CPathId TTargetIdLLunId). См. следующий раздел "Примечания" для таблицы, в которую перечислены части этой строки.
Примечание.
Для образов Hyper-V и VHD это свойство равно NULL, так как виртуальный контроллер не возвращает путь к расположению.
Дополнительные сведения об этом свойстве см. в следующем разделе "Примечания".
LogicalSectorSize
Тип данных: UInt32
Тип доступа: только для чтения
Квалификаторы: единицы (байты)
Размер логического сектора диска в байтах. Например, собственный диск 4K будет сообщать 4096, а эмулированный диск 512 будет сообщать 512.
Производитель
Тип данных: Строка
Тип доступа: только для чтения
Строковое представление производителя оборудования диска.
Модель
Тип данных: Строка
Тип доступа: только для чтения
Строковое представление номера модели диска.
Число
Тип данных: UInt32
Тип доступа: только для чтения
Номер операционной системы для диска. Диск 0 обычно является загрузочным устройством. Номера дисков могут не обязательно оставаться одинаковыми во время перезапуска.
NumberOfPartitions
Тип данных: UInt32
Тип доступа: только для чтения
Количество секций, созданных на диске.
Автономныйreason
Тип данных: UInt16
Тип доступа: только для чтения
Если IsOffline имеет значение TRUE, это свойство содержит причину автономного работы диска.
Одно из следующих значений.
| Значение | Значение |
|---|---|
| Политика 1 | Пользователь попросил диск быть в автономном режиме. |
| Избыточный путь 2 | Диск используется для многопутьных операций ввода-вывода. |
| Моментальный снимок 3 | Диск — это диск моментального снимка. |
| Столкновение 4 | Возникла сигнатура или столкновение идентификаторов с другим диском. |
| Исчерпание ресурсов 5 | Недостаточно ресурсов для подключения диска к сети. |
| Критические ошибки записи 6 | На диске произошли критические сбои записи. |
| Проверка целостности данных требуется 7 | Требуется проверка целостности данных. |
OperationsStatus
Тип данных: UInt16
Тип доступа: только для чтения
Состояние работы устройства с диском.
| Значение | Значение |
|---|---|
| Неизвестно 0 | Состояние работы неизвестно. |
| Другие 1 | Для конкретного поставщика OperationsStatus задано свойство OtherOperationalStatusDescription. |
| ОК 2 | Диск отвечает на команды и находится в обычном состоянии работы. |
| Деградированные 3 | Диск отвечает на команды, но не работает в оптимальном состоянии работы. |
| Подчеркнул 4 | Диск работает, но требует внимания. Например, диск может быть перегружен или перегрев. |
| Прогнозная ошибка 5 | Диск работает, но сбой, скорее всего, произойдет в ближайшем будущем. |
| Ошибка 6 | Произошла ошибка. |
| Невосстановимая ошибка 7 | Произошла невосстановимая ошибка. |
| Начиная с 8 | Диск находится в процессе запуска. |
| Остановка 9 | Диск находится в процессе остановки. |
| Остановлено 10 | Диск был остановлен или закрыт в чистом и упорядоченном режиме. |
| В службе 11 | Диск настраивается, поддерживается, очищается или управляется в противном случае. |
| Нет контакта 12 | Поставщик хранилища имеет знания о диске, но никогда не смог установить связь с ним. |
| Потерянный обмен данными 13 | Поставщик хранилища знает о диске и успешно связался с ним в прошлом, но диск в настоящее время недоступен. |
| Прервано 14 | Аналогично остановке, за исключением того, что диск остановился резко и может потребовать настройки или обслуживания. |
| Dormant 15 | Диск доступен, но он неактивен. |
| Поддержка сущности в ошибке 16 | Это значение состояния не обязательно указывает на проблемы с диском, но это означает, что другое устройство или подключение, от чего зависит диск, может потребоваться внимание. |
| Завершено 17 | Диск завершил операцию. Это значение состояния должно быть объединено с ОК, Ошибка или Понижение в зависимости от результата операции. |
| Веб-0xD010 | В подсистемах хранилища под управлением Windows это означает, что объект находится в сети. |
| Не готово 0xD011 | В подсистемах хранилища под управлением Windows это означает, что объект не готов. |
| Нет 0xD012 мультимедиа | В подсистемах хранилища под управлением Windows это означает, что у объекта нет носителя. |
| Автономные 0xD013 | В подсистемах хранилища под управлением Windows это означает, что объект находится в автономном режиме. |
| Сбой 0xD014 | В подсистемах хранилища под управлением Windows это означает, что объект находится в состоянии сбоя. |
PartitionStyle
Тип данных: UInt16
Тип доступа: только для чтения
Квалификаторы: обязательный
Стиль секции, используемый диском.
| Значение | Значение |
|---|---|
| Неизвестно 0 | Стиль секции неизвестен. |
| MBR 1 | Основная загрузочная запись (MBR), |
| GPT 2 | Таблица секций GUID (GPT) |
Путь
Тип данных: Строка
Тип доступа: только для чтения
Квалификаторы: обязательный
Путь, который можно использовать для открытия дескриптора операционной системы на диске.
PhysicalSectorSize
Тип данных: UInt32
Тип доступа: только для чтения
Квалификаторы: единицы (байты)
Размер физического сектора диска в байтах. Например, 4K собственных дисков и 512 эмулированных дисков будут сообщать 4096.
ProvisioningType
Тип данных: UInt16
Тип доступа: только для чтения
Тип подготовки устройства диска.
| Значение | Значение |
|---|---|
| Неизвестно 0 | Схема подготовки не указана. |
| Тонкий 1 | Хранилище для диска выделяется по запросу. |
| Исправлено 2 | Хранилище выделяется при создании диска. |
SerialNumber
Тип данных: Строка
Тип доступа: только для чтения
Строковое представление серийного номера диска.
Подпись
Тип данных: UInt32
Тип доступа: только для чтения
Если partitionStyle имеет значение MBR, это свойство содержит сигнатуру секции MBR. Это свойство будет иметь значение NULL для всех других типов дисков.
Размер
Тип данных: UInt64
Тип доступа: только для чтения
Квалификаторы: обязательные, единицы (байты)
Общий размер диска в байтах.
UniqueId
Тип данных: Строка
Тип доступа: только для чтения
Идентификатор диска. Это содержит страницу VPD 0x83 информацию, которая однозначно идентифицирует этот диск. Принимаются следующие типы (в порядке приоритета):
- 8 (строка имени SCSI)
- 3 (имя FCPH)
- 2 (EUI64)
- 1 (идентификатор поставщика)
- 0 (конкретный поставщик)
Если диск является предоставленным виртуальным диском, uniqueId используется для сопоставления связи между двумя объектами.
UniqueIdFormat
Тип данных: UInt16
Тип доступа: только для чтения
Квалификаторы: значения ("Конкретный поставщик", "Идентификатор поставщика", "EUI64", "FCPH Name", "Строка имени SCSI" ), ValueMap ("0", "1", "2", "3", "8")
Формат идентификатора диска. Это свойство содержит тип дескриптора страницы VPD 0x83, который использовался для задания свойства UniqueId .
Замечания
В следующей таблице перечислены части строки пути расположения, используемой в свойстве Location .
| Часть пути расположения | Description |
|---|---|
| AdapterPnpLocationPath | Путь расположения PnP адаптера. Это извлекается путем вызова функции SetupDiGetDeviceProperty , передав &DEVPKEY_Device_LocationPaths для параметра PropertyKey . |
| BusType | Тип шины: ATA, RAID, SAS или SCSI. Примечание. Если тип шины — IDE, PATA или SATA, он отображается как ATA в строке пути расположения. Если это RAID-интерфейс PCI, он отображается как RAID. |
| PathId | Номер автобуса. Это значение элемента PathId структуры SCSI_ADDRESS , возвращаемой кодом элемента управления IOCTL_SCSI_GET_ADDRESS . |
| TargetId | Число целевого устройства. Это значение элемента TargetId структуры SCSI_ADDRESS, возвращаемой кодом элемента управления IOCTL_SCSI_GET_ADDRESS. |
| LunId | Число LUN. Это значение элемента Lun структуры SCSI_ADDRESS , возвращаемой кодом элемента управления IOCTL_SCSI_GET_ADDRESS . |
В следующей таблице приведены примеры путей расположения.
| Тип шины | Пример пути расположения |
|---|---|
| ATA | PCIROOT(0)#PCI(0100)#ATA(C01T03L00) |
| RAID | PCIROOT(0)#PCI(0200)#PCI(0003)#PCI(0100)#RAID(P02T00L00) |
| SAS | PCIROOT(1)#PCI(0300)#SAS(P00T03L00) |
| SCSI | PCIROOT(0)#PCI(1C00)#PCI(0000)#SCSI(P00T01L01) |
Начиная с Windows 10: MSFT_Disk является производным от MSFT_StorageObject. Теперь он наследует свойство ObjectId, которое ранее было свойством MSFT_Disk.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Пространство имен | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |