struktur CHANGER_ELEMENT_STATUS (winioctl.h)

  • Artikel

Mewakili status elemen yang ditentukan.

Sintaks

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;

Anggota

Element

Struktur CHANGER_ELEMENT yang mewakili elemen .

SrcElementAddress

Struktur CHANGER_ELEMENT yang mewakili elemen tempat media saat ini dalam elemen ini baru-baru ini dipindahkan.

Anggota ini hanya valid jika anggota Bendera menyertakan ELEMENT_STATUS_SVALID.

Flags

Status elemen. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Makna
ELEMENT_STATUS_ACCESS
0x00000008
 Elemen transportasi pengubah dapat mengakses bagian media dalam elemen ini. Media tidak dapat diakses dalam keadaan berikut: (1) Jika jenis elemen adalah ChangerSlot, slot tidak ada di changer (misalnya, majalah yang berisi slot telah dihapus secara fisik). (2) Jika jenis elemen adalah ChangerDrive, drive rusak atau telah dihapus. (3) Jika jenis elemen adalah ChangerIEPort, port insert/eject pengubah diperluas.
ELEMENT_STATUS_AVOLTAG
0x20000000
 Informasi volume alternatif di anggota AlternateVolumeID valid.
ELEMENT_STATUS_EXCEPT
0x00000004
 Elemen ini dalam keadaan abnormal. Periksa anggota ExceptionCode untuk informasi selengkapnya.
ELEMENT_STATUS_EXENAB
0x00000010
 Elemen mendukung ekspor media melalui port insert/eject pengubah.
ELEMENT_STATUS_FULL
0x00000001
 Elemen berisi sepotong media.

Perhatikan bahwa nilai ini hanya valid jika jenis elemen adalah ChangerDrive, ChangerSlot, atau ChangerTransport. Jika ElementType adalah ChangerIEPort, nilai ini hanya valid jika anggota Fitur0GET_CHANGER_PARAMETERS menyertakan CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 ID target SCSI di anggota TargetID valid.

Nilai ini hanya valid jika jenis elemennya adalah ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 Media dalam elemen ini ditempatkan di sana oleh operator.

Nilai ini hanya valid jika jenis elemen adalah ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 Elemen mendukung impor media melalui port insert/eject pengubah.
ELEMENT_STATUS_INVERT
0x00400000
 Media dalam elemen dibalik.

Nilai ini hanya valid jika ELEMENT_STATUS_SVALID juga disertakan.
ELEMENT_STATUS_LUN_VALID
0x00001000
 Nomor unit logis di anggota Lun valid. Nilai ini hanya valid jika jenis elemennya adalah ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 Drive di alamat yang ditunjukkan oleh Lun dan TargetID berada di bus SCSI yang berbeda dari changer itu sendiri.
ELEMENT_STATUS_PVOLTAG
0x10000000
 Informasi volume utama di anggota PrimaryVolumeID valid.
ELEMENT_STATUS_SVALID
0x00800000
 Anggota SourceElement dan ELEMENT_STATUS_INVERT keduanya valid.

ExceptionCode

Kode pengecualian yang menunjukkan bahwa elemen dalam keadaan abnormal. Anggota ini hanya valid jika anggota Bendera menyertakan ELEMENT_STATUS_EXCEPT. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 Drive di alamat elemen ini tidak ada.
ERROR_LABEL_QUESTIONABLE
0x00000002
 Label mungkin tidak valid karena kondisi perhatian unit.
ERROR_LABEL_UNREADABLE
0x00000001
 Pembaca kode batang pengubah tidak dapat membaca label kode batang pada bagian media dalam elemen ini, karena media hilang, rusak, diposisikan secara tidak benar, atau terbalik.
ERROR_SLOT_NOT_PRESENT
0x00000004
 Slot di alamat elemen ini saat ini tidak diinstal di pengubah. Setiap slot di majalah yang dapat dilepas dilaporkan tidak ada untuk menunjukkan bahwa majalah telah dihapus.
ERROR_TRAY_MALFUNCTION
0x00000010
 Drive pada alamat elemen ini memiliki baki yang harus diperluas untuk memuat atau menghapus media, dan baki tidak diperluas sesuai kebutuhan.
ERROR_UNHANDLED_ERROR
0xFFFFFFFF
 Kondisi kesalahan tidak diketahui.

TargetId

Untuk pengubah SCSI, menentukan ID target SCSI drive di alamat elemen ini. Anggota ini hanya valid jika anggota ElementType dari struktur Elemen adalah ChangerDrive dan anggota Bendera menyertakan ELEMENT_STATUS_ID_VALID.

Lun

Nomor unit logis SCSI dari drive di alamat elemen ini. Anggota ini hanya valid jika anggota ElementType dari struktur Elemen adalah ChangerDrive dan anggota Bendera menyertakan ELEMENT_STATUS_LUN_VALID.

Reserved

Disiapkan untuk penggunaan masa mendatang. Nilai anggota ini harus nol.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Pengidentifikasi volume utama untuk media. Jika pengubah mendukung pembaca kode batang dan pembaca diinstal (seperti yang ditunjukkan oleh CHANGER_BAR_CODE_SCANNER_INSTALLED di anggota Fitur0GET_CHANGER_PARAMETERS), PrimaryVolumeID adalah kode batang media. Jika pengubah tidak mendukung pembaca kode batang, PrimaryVolumeID adalah nilai yang sebelumnya ditetapkan ke media.

Anggota ini hanya valid jika anggota Bendera menyertakan ELEMENT_STATUS_PVOLTAG.

Jika pengidentifikasi volume hilang atau tidak dapat dibaca, anggota ini akan dihapus.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Identifikasi volume alternatif untuk media. Anggota ini hanya berlaku untuk media dua sisi, dan berkaitan dengan ID sisi terbalik. Ini tidak pernah mewakili kode batang.

Anggota ini hanya valid jika anggota Bendera menyertakan ELEMENT_STATUS_AVOLTAG.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP
Server minimum yang didukung Windows Server 2003
Header winioctl.h (termasuk Windows.h)

Lihat juga

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS