次の方法で共有

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

要素の状態。 このメンバーには、次の値の 1 つ以上を指定できます。

値 意味
ELEMENT_STATUS_ACCESS
0x00000008
 changer のトランスポート要素は、この要素内のメディアの一部にアクセスできます。 (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が含まれている場合にのみ有効です。

ボリューム ID が見つからないか、読み取り不可能な場合、このメンバーはクリアされます。

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

メディアの代替ボリューム ID。 このメンバーは両面メディアに対してのみ有効であり、反転側の ID に関連します。 バー コードを表すことはありません。

このメンバーは、 Flags メンバーにELEMENT_STATUS_AVOLTAGが含まれている場合にのみ有効です。

要件

要件 値
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
Header winioctl.h (Windows.h を含む)

こちらもご覧ください

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS