Compartilhar via

estrutura CHANGER_ELEMENT_STATUS (winioctl.h)

  • Artigo

Representa o status do elemento especificado.

Sintaxe

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;

Membros

Element

Uma estrutura CHANGER_ELEMENT que representa o elemento .

SrcElementAddress

Uma estrutura CHANGER_ELEMENT que representa o elemento do qual a mídia atualmente neste elemento foi movida mais recentemente.

Esse membro só será válido se o membro Flags incluir ELEMENT_STATUS_SVALID.

Flags

O elemento status. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
ELEMENT_STATUS_ACCESS
0x00000008
 O elemento de transporte do alterador pode acessar a parte da mídia nesse elemento. A mídia não está acessível nas seguintes circunstâncias: (1) Se o tipo de elemento for ChangerSlot, o slot não estará presente no alterador (por exemplo, a revista que contém o slot foi removida fisicamente). (2) Se o tipo de elemento for ChangerDrive, a unidade será interrompida ou removida. (3) Se o tipo de elemento for ChangerIEPort, a porta de inserção/ejeção do alterador será estendida.
ELEMENT_STATUS_AVOLTAG
0x20000000
 As informações de volume alternativo no membro AlternateVolumeID são válidas.
ELEMENT_STATUS_EXCEPT
0x00000004
 O elemento está em um estado anormal. Verifique o membro ExceptionCode para obter mais informações.
ELEMENT_STATUS_EXENAB
0x00000010
 O elemento dá suporte à exportação de mídia por meio da porta de inserção/ejeção do alterador.
ELEMENT_STATUS_FULL
0x00000001
 O elemento contém uma parte da mídia.

Observe que esse valor só será válido se o tipo de elemento for ChangerDrive, ChangerSlot ou ChangerTransport. Se ElementType for ChangerIEPort, esse valor será válido somente se o membro Features0 do GET_CHANGER_PARAMETERS incluir CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 A ID de destino SCSI no membro TargetID é válida.

Esse valor só será válido se o tipo de elemento for ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 A mídia nesse elemento foi colocada lá por um operador .

Esse valor só será válido se o tipo de elemento for ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 O elemento dá suporte à importação de mídia por meio da porta de inserção/ejeção do alterador.
ELEMENT_STATUS_INVERT
0x00400000
 A mídia no elemento foi invertida.

Esse valor será válido somente se ELEMENT_STATUS_SVALID também estiver incluído.
ELEMENT_STATUS_LUN_VALID
0x00001000
 O número da unidade lógica no membro Lun é válido. Esse valor só será válido se o tipo de elemento for ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 A unidade no endereço indicado por Lun e TargetID está em um barramento SCSI diferente do próprio alterador.
ELEMENT_STATUS_PVOLTAG
0x10000000
 As informações de volume primário no membro PrimaryVolumeID são válidas.
ELEMENT_STATUS_SVALID
0x00800000
 O membro SourceElement e ELEMENT_STATUS_INVERT são válidos.

ExceptionCode

Um código de exceção que indica que o elemento está em um estado anormal. Esse membro só será válido se o membro Flags incluir ELEMENT_STATUS_EXCEPT. Esse membro pode ser um dos valores a seguir.

Valor Significado
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 A unidade neste endereço de elemento está ausente.
ERROR_LABEL_QUESTIONABLE
0x00000002
 O rótulo pode ser inválido devido a uma condição de atenção da unidade.
ERROR_LABEL_UNREADABLE
0x00000001
 O leitor de código de barras do alterador não pôde ler o rótulo de código de barras na parte da mídia neste elemento, pois a mídia está ausente, danificada, posicionada incorretamente ou de cabeça para baixo.
ERROR_SLOT_NOT_PRESENT
0x00000004
 Atualmente, o slot neste endereço de elemento não está instalado no alterador. Cada slot em uma revista removível não está presente para indicar que a revista foi removida.
ERROR_TRAY_MALFUNCTION
0x00000010
 A unidade neste endereço de elemento tem uma bandeja que deve ser estendida para carregar ou remover mídia, e a bandeja não está se estendendo conforme necessário.
ERROR_UNHANDLED_ERROR
0xFFFFFFFF
 Condição de erro desconhecida.

TargetId

Para um alterador SCSI, especifica a ID de destino SCSI da unidade nesse endereço de elemento. Esse membro só será válido se o membro ElementType da estrutura Element for ChangerDrive e o membro Flags incluir ELEMENT_STATUS_ID_VALID.

Lun

O número da unidade lógica SCSI da unidade nesse endereço de elemento. Esse membro só será válido se o membro ElementType da estrutura Element for ChangerDrive e o membro Flags incluir ELEMENT_STATUS_LUN_VALID.

Reserved

Reservado para uso futuro. O valor desse membro deve ser zero.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

O identificador de volume primário para a mídia. Se o alterador der suporte a um leitor de código de barras e o leitor estiver instalado (conforme indicado por CHANGER_BAR_CODE_SCANNER_INSTALLED no membro Features0 do GET_CHANGER_PARAMETERS), PrimaryVolumeID será o código de barras da mídia. Se o alterador não der suporte a um leitor de código de barras, PrimaryVolumeID será o valor atribuído anteriormente à mídia.

Esse membro só será válido se o membro Flags incluir ELEMENT_STATUS_PVOLTAG.

Se o identificador de volume estiver ausente ou ilegível, esse membro será limpo.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Uma identificação de volume alternativa para a mídia. Esse membro é válido apenas para mídia de dois lados e pertence à ID do lado invertido. Ele nunca representa um código de barras.

Esse membro só será válido se o membro Flags incluir ELEMENT_STATUS_AVOLTAG.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS