структура NTMS_DRIVEINFORMATIONA (ntmsapi.h)

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Структура NTMS_DRIVEINFORMATION определяет свойства, относящиеся к объекту диска.

Синтаксис

typedef struct _NTMS_DRIVEINFORMATIONA {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  CHAR       szDeviceName[NTMS_DEVICENAME_LENGTH];
  CHAR       szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  CHAR       szRevision[NTMS_REVISION_LENGTH];
  WORD       ScsiPort;
  WORD       ScsiBus;
  WORD       ScsiTarget;
  WORD       ScsiLun;
  DWORD      dwMountCount;
  SYSTEMTIME LastCleanedTs;
  NTMS_GUID  SavedPartitionId;
  NTMS_GUID  Library;
  GUID       Reserved;
  DWORD      dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONA;

Члены

Number

Номер диска в библиотеке. Это значение равно нулю или одному относительного значения, основанного на системе нумеровки дисков устройства. В некоторых устройствах смены число дисков начинается с нуля, а для некоторых — с одного.

State

Состояние диска. Это может быть одно из следующих значений.

Значение	Значение
NTMS_DRIVESTATE_BEING_CLEANED	Диск очищается и недоступен.
NTMS_DRIVESTATE_DISMOUNTABLE	Если библиотека настроена для отложенных отключений, носитель может быть оставлен на диске библиотеки при отключении. RSM может удовлетворять запросы на подключение для загруженных и отключенных дисков.
NTMS_DRIVESTATE_DISMOUNTED	Нет среды в диске.
NTMS_DRIVESTATE_LOADED	Среда подключается к диску и загружается для чтения и записи.
NTMS_DRIVESTATE_MOUNTED	Среда подключена к диску, но не готова к доступу на чтение и запись. Это временное состояние, которое используется, когда диск ожидает синхронизации шпинделя или загрузки ленточного носителя в головной механизм.
NTMS_DRIVESTATE_UNLOADED	Носитель был отключен диском и готов к открытию. Это состояние означает, что шпиндель остановлен или ленточный носитель был возвращен в ленточный патрон.

DriveType

Уникальный идентификатор объекта типа диска, содержащего атрибуты для диска.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Имя устройства, используемого для доступа к диску. Для ленточного накопителя он содержит имя устройства \.\tape0 или \.\tape1. Другие устройства предоставляют имя диска SCSI или корень файловой системы, в которую в настоящее время подключено устройство (raw, NTFS, FAT и т. д.).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Серийный номер диска, представленный в виде строки. Устройства, не поддерживающие серийные номера, сообщают о значении NULL для этого элемента.

szRevision[NTMS_REVISION_LENGTH]

Редакция для диска, представленная в виде строки.

ScsiPort

Адаптер узла SCSI, к которому подключен диск.

ScsiBus

Шина SCSI, к которой подключен диск.

ScsiTarget

Идентификатор целевого объекта SCSI для диска.

ScsiLun

Идентификатор логической единицы SCSI для диска.

dwMountCount

Количество раз, когда к диску была подключена среда. Если диск поддерживает отчеты об уникальном серийном номере, это значение представляет собой количество подключенных дисков с момента установки. Если диск не поддерживает отчеты о серийных номерах, этот элемент отражает количество подключений ко всем дискам в этом расположении.

LastCleanedTs

Время последней очистки диска.

SavedPartitionId

Идентификатор секции среды, которая находится на диске. Если это значение равно NULL и диск найден полным, носитель был загружен пользователем и должен быть классифицирован.

Library

Уникальный идентификатор библиотеки, содержащей диск.

Reserved

Зарезервировано.

dwDeferDismountDelay

Минимальное количество секунд среда останется на диске библиотеки после отложенного отключения. Значение по умолчанию равно 5 минутам. Этот элемент не применяется к автономным библиотекам. Этот элемент доступен для записи.

Комментарии

Структура NTMS_DRIVEINFORMATION включается в структуру NTMS_OBJECTINFORMATION .

Примечание

Заголовок ntmsapi.h определяет NTMS_DRIVEINFORMATION в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также раздел

NTMS_OBJECTINFORMATION