структура CHANGER_ELEMENT_STATUS (winioctl.h)

  • Статья

Представляет состояние указанного элемента.

Синтаксис

typedef struct _CHANGER_ELEMENT_STATUS {
  CHANGER_ELEMENT Element;
  CHANGER_ELEMENT SrcElementAddress;
  DWORD           Flags;
  DWORD           ExceptionCode;
  BYTE            TargetId;
  BYTE            Lun;
  WORD            Reserved;
  BYTE            PrimaryVolumeID[MAX_VOLUME_ID_SIZE];
  BYTE            AlternateVolumeID[MAX_VOLUME_ID_SIZE];
} CHANGER_ELEMENT_STATUS, *PCHANGER_ELEMENT_STATUS;

Члены

Element

Структура CHANGER_ELEMENT , представляющая элемент .

SrcElementAddress

Структура CHANGER_ELEMENT, представляющая элемент, из которого был недавно перемещен носитель в этом элементе.

Этот член действителен, только если элемент Flags включает ELEMENT_STATUS_SVALID.

Flags

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

Значение Значение
ELEMENT_STATUS_ACCESS
0x00000008
 Элемент транспорта меняющего элемента может получить доступ к элементу мультимедиа в этом элементе. Носитель недоступен в следующих случаях: (1) Если тип элемента — ChangerSlot, слот отсутствует в средстве смены (например, журнал, содержащий слот, был физически удален). (2) Если тип элемента — ChangerDrive, диск не работает или удаляется. (3) Если тип элемента — ChangerIEPort, порт вставки и извлечения меняющего устройства расширяется.
ELEMENT_STATUS_AVOLTAG
0x20000000
 Сведения о альтернативном томе в элементе AlternateVolumeID являются допустимыми .
ELEMENT_STATUS_EXCEPT
0x00000004
 Элемент находится в ненормальном состоянии. Дополнительные сведения см. в элементе ExceptionCode .
ELEMENT_STATUS_EXENAB
0x00000010
 Элемент поддерживает экспорт мультимедиа через порт вставки и извлечения.
ELEMENT_STATUS_FULL
0x00000001
 Элемент содержит элемент мультимедиа.

Обратите внимание, что это значение допустимо, только если тип элемента — ChangerDrive, ChangerSlot или ChangerTransport. Если элемент ElementType имеет значение ChangerIEPort, это значение допустимо, только если элемент Features0GET_CHANGER_PARAMETERS включает CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 Допустимый идентификатор целевого объекта SCSI в элементе TargetID .

Это значение допустимо, только если тип элемента — ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 Носитель в этом элементе был помещен туда оператором .

Это значение допустимо, только если тип элемента — ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 Элемент поддерживает импорт мультимедиа через порт вставки и извлечения средства смены.
ELEMENT_STATUS_INVERT
0x00400000
 Носитель в элементе был перевернут.

Это значение допустимо только в том случае, если также включены ELEMENT_STATUS_SVALID.
ELEMENT_STATUS_LUN_VALID
0x00001000
 Допустимый номер логической единицы в элементе Lun . Это значение допустимо, только если тип элемента — ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 Диск по адресу, указанному Lun и TargetID , находится на шине SCSI, отличной от самого контроллера.
ELEMENT_STATUS_PVOLTAG
0x10000000
 Сведения о первичном томе в элементе PrimaryVolumeID являются допустимыми .
ELEMENT_STATUS_SVALID
0x00800000
 Член SourceElement и ELEMENT_STATUS_INVERT являются допустимыми.

ExceptionCode

Код исключения, указывающий, что элемент находится в аномальном состоянии. Этот элемент действителен, только если элемент Flags включает ELEMENT_STATUS_EXCEPT. Этот элемент может быть одним из следующих значений.

Значение Значение
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 Диск по адресу этого элемента отсутствует.
ERROR_LABEL_QUESTIONABLE
0x00000002
 Метка может быть недопустимой из-за состояния внимания единицы измерения.
ERROR_LABEL_UNREADABLE
0x00000001
 Средству чтения штрихкода не удалось прочитать метку штрихкода на элементе носителя в этом элементе, так как носитель отсутствует, поврежден, неправильно расположен или перевернут.
ERROR_SLOT_NOT_PRESENT
0x00000004
 Слот по этому адресу элемента в настоящее время не установлен в средство смены. Сообщается, что каждый слот в съемном журнале отсутствует, чтобы указать, что журнал был удален.
ERROR_TRAY_MALFUNCTION
0x00000010
 Диск с этим адресом элемента имеет область, которую необходимо расширить для загрузки или удаления носителя, и область не расширяется должным образом.
ERROR_UNHANDLED_ERROR
0xFFFFFFFF
 Неизвестное условие ошибки.

TargetId

Для SCSI-контроллера указывает идентификатор целевого объекта SCSI диска по адресу этого элемента. Этот элемент действителен, только если элемент ElementType структуры Element — ChangerDrive, а элемент Flags включает ELEMENT_STATUS_ID_VALID.

Lun

Номер логической единицы SCSI диска по адресу этого элемента. Этот элемент действителен, только если элемент ElementType структуры Element — ChangerDrive, а элемент Flags включает ELEMENT_STATUS_LUN_VALID.

Reserved

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

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Идентификатор основного тома для носителя. Если средство смены поддерживает средство чтения штрихкодов и средство чтения установлено (как указано в CHANGER_BAR_CODE_SCANNER_INSTALLED в элементе Features0GET_CHANGER_PARAMETERS), PrimaryVolumeID — это линейчатый код носителя. Если средство смены не поддерживает средство чтения штрихкодов, PrimaryVolumeID — это значение, ранее назначенное носителю.

Этот элемент действителен, только если элемент Flags включает ELEMENT_STATUS_PVOLTAG.

Если идентификатор тома отсутствует или не читается, этот элемент удаляется.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Альтернативный идентификатор тома для носителя. Этот элемент действителен только для двусторонних носителей и относится к идентификатору инвертированного элемента. Он никогда не представляет линейчатый код.

Этот элемент действителен, только если элемент Flags содержит ELEMENT_STATUS_AVOLTAG.

Требования

Требование Значение
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Верхняя часть winioctl.h (включая Windows.h)

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

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS