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

Статья
11/20/2024

[Диспетчер съемных носителей больше не доступен в 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 или корневой каталог файловой системы, на которой в настоящее время подключено устройство (необработанное, 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

Поделиться через