Share via

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인 경우 이 값은 GET_CHANGER_PARAMETERS Features0 멤버에 CHANGER_REPORT_IEPORT_STATE 포함된 경우에만 유효합니다.
ELEMENT_STATUS_ID_VALID
0x00002000
 TargetID 멤버의 SCSI 대상 ID가 유효합니다.

이 값은 요소 형식이 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 대상 ID를 지정합니다. 이 멤버는 Element 구조체의 ElementType 멤버가 ChangerDrive이고 Flags 멤버에 ELEMENT_STATUS_ID_VALID 포함된 경우에만 유효합니다.

Lun

이 요소 주소에 있는 드라이브의 SCSI 논리 단위 번호입니다. 이 멤버는 Element 구조체의 ElementType 멤버가 ChangerDrive이고 Flags 멤버에 ELEMENT_STATUS_LUN_VALID 포함되어 있는 경우에만 유효합니다.

Reserved

다음에 사용하도록 예약됩니다. 이 멤버의 값은 0이어야 합니다.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

미디어의 기본 볼륨 식별자입니다. 변경기가 바코드 판독기를 지원하고 판독기가 설치된 경우(GET_CHANGER_PARAMETERS Features0 멤버의 CHANGER_BAR_CODE_SCANNER_INSTALLED 표시) PrimaryVolumeID 는 미디어의 바코드입니다. 변경 프로그램이 바코드 판독기를 지원하지 않는 경우 PrimaryVolumeID 는 이전에 미디어에 할당된 값입니다.

이 멤버는 Flags 멤버에 ELEMENT_STATUS_PVOLTAG 포함하는 경우에만 유효합니다.

볼륨 식별자가 없거나 읽을 수 없는 경우 이 멤버는 지워집니다.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

미디어에 대한 대체 볼륨 식별입니다. 이 멤버는 양면 미디어에만 유효하며 반전된 면의 ID와 관련이 있습니다. 바코드를 나타내지 않습니다.

이 멤버는 Flags 멤버에 ELEMENT_STATUS_AVOLTAG 포함하는 경우에만 유효합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
머리글 winioctl.h(Windows.h 포함)

추가 정보

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS