Compartir a través de

estructura CHANGER_ELEMENT_STATUS (winioctl.h)

  • Artículo

Representa el estado del elemento especificado.

Sintaxis

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;

Miembros

Element

Estructura CHANGER_ELEMENT que representa el elemento .

SrcElementAddress

Estructura CHANGER_ELEMENT que representa el elemento desde el que se movió el medio actualmente en este elemento.

Este miembro solo es válido si el miembro Flags incluye ELEMENT_STATUS_SVALID.

Flags

Estado del elemento. Este miembro puede ser uno o varios de los valores siguientes.

Valor Significado
ELEMENT_STATUS_ACCESS
0x00000008
 El elemento de transporte del modificador puede tener acceso al elemento multimedia de este elemento. Los medios no son accesibles en las siguientes circunstancias: (1) Si el tipo de elemento es ChangerSlot, la ranura no está presente en el modificador (por ejemplo, la revista que contiene la ranura se ha quitado físicamente). (2) Si el tipo de elemento es ChangerDrive, la unidad se interrumpe o se ha quitado. (3) Si el tipo de elemento es ChangerIEPort, el puerto de inserción y expulsión del modificador se extiende.
ELEMENT_STATUS_AVOLTAG
0x20000000
 La información alternativa del volumen en el miembro AlternateVolumeID es válida.
ELEMENT_STATUS_EXCEPT
0x00000004
 El elemento está en un estado anómalo. Consulte el miembro ExceptionCode para obtener más información.
ELEMENT_STATUS_EXENAB
0x00000010
 El elemento admite la exportación de medios a través del puerto de inserción/expulsión del modificador.
ELEMENT_STATUS_FULL
0x00000001
 El elemento contiene un fragmento de medio.

Tenga en cuenta que este valor solo es válido si el tipo de elemento es ChangerDrive, ChangerSlot o ChangerTransport. Si ElementType es ChangerIEPort, este valor solo es válido si el miembro Features0 de GET_CHANGER_PARAMETERS incluye CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 El identificador de destino SCSI del miembro TargetID es válido.

Este valor solo es válido si el tipo de elemento es ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 Un operador colocó allí el medio de este elemento.

Este valor solo es válido si el tipo de elemento es ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 El elemento admite la importación de medios a través del puerto de inserción y expulsión del modificador.
ELEMENT_STATUS_INVERT
0x00400000
 El medio del elemento se ha volteado.

Este valor solo es válido si también se incluye ELEMENT_STATUS_SVALID.
ELEMENT_STATUS_LUN_VALID
0x00001000
 El número de unidad lógica del miembro Lun es válido. Este valor solo es válido si el tipo de elemento es ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 La unidad en la dirección indicada por Lun y TargetID está en un bus SCSI diferente que el propio modificador.
ELEMENT_STATUS_PVOLTAG
0x10000000
 La información del volumen principal del miembro PrimaryVolumeID es válida.
ELEMENT_STATUS_SVALID
0x00800000
 El miembro SourceElement y ELEMENT_STATUS_INVERT son válidos.

ExceptionCode

Código de excepción que indica que el elemento está en un estado anómalo. Este miembro solo es válido si el miembro Flags incluye ELEMENT_STATUS_EXCEPT. Este miembro puede ser uno de los valores siguientes.

Valor Significado
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 La unidad de esta dirección de elemento no está presente.
ERROR_LABEL_QUESTIONABLE
0x00000002
 La etiqueta podría no ser válida debido a una condición de atención unitaria.
ERROR_LABEL_UNREADABLE
0x00000001
 El lector de códigos de barras del cambiador no pudo leer la etiqueta de código de barras en el elemento multimedia de este elemento, porque falta el medio, está dañado, colocado incorrectamente o al revés.
ERROR_SLOT_NOT_PRESENT
0x00000004
 La ranura de esta dirección de elemento no está instalada actualmente en el modificador. Cada ranura de una revista extraíble no está presente para indicar que se ha eliminado la revista.
ERROR_TRAY_MALFUNCTION
0x00000010
 La unidad de esta dirección de elemento tiene una bandeja que debe extenderse para cargar o quitar medios, y la bandeja no se extiende según sea necesario.
ERROR_UNHANDLED_ERROR
0xffffffff
 Condición de error desconocida.

TargetId

Para un modificador SCSI, especifica el identificador de destino SCSI de la unidad en esta dirección de elemento. Este miembro solo es válido si el miembro ElementType de la estructura Element es ChangerDrive y el miembro Flags incluye ELEMENT_STATUS_ID_VALID.

Lun

Número de unidad lógica SCSI de la unidad en esta dirección de elemento. Este miembro solo es válido si el miembro ElementType de la estructura Element es ChangerDrive y el miembro Flags incluye ELEMENT_STATUS_LUN_VALID.

Reserved

Reservado para uso futuro. El valor de este miembro debe ser cero.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Identificador de volumen principal para el medio. Si el modificador admite un lector de códigos de barras y el lector se instala (como se indica en CHANGER_BAR_CODE_SCANNER_INSTALLED en el miembro Features0 de GET_CHANGER_PARAMETERS), PrimaryVolumeID es el código de barras del medio. Si el modificador no admite un lector de códigos de barras, PrimaryVolumeID es el valor asignado previamente al medio.

Este miembro solo es válido si el miembro Flags incluye ELEMENT_STATUS_PVOLTAG.

Si falta el identificador de volumen o no se puede leer, se borra este miembro.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Una identificación de volumen alternativa para los medios. Este miembro solo es válido para medios de dos lados y pertenece al identificador del lado invertido. Nunca representa un código de barras.

Este miembro solo es válido si el miembro Flags incluye ELEMENT_STATUS_AVOLTAG.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Servidor mínimo compatible Windows Server 2003
Encabezado winioctl.h (incluye Windows.h)

Consulte también

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS