winioctl.h (CHANGER_ELEMENT_STATUS_EX 结构)
表示指定元素的状态。
语法
typedef struct _CHANGER_ELEMENT_STATUS_EX {
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];
BYTE VendorIdentification[VENDOR_ID_LENGTH];
BYTE ProductIdentification[PRODUCT_ID_LENGTH];
BYTE SerialNumber[SERIAL_NUMBER_LENGTH];
} CHANGER_ELEMENT_STATUS_EX, *PCHANGER_ELEMENT_STATUS_EX;
成员
Element
表示此结构引用的元素 的CHANGER_ELEMENT 结构。
SrcElementAddress
一个CHANGER_ELEMENT结构，表示最近从中移动当前此元素中的媒体的元素。
仅当 Flags 成员包含ELEMENT_STATUS_SVALID时，此成员才有效。
Flags
元素状态。 此成员可以是以下一个或多个值。
| 值 | 含义 |
|---|---|
|
更换器的传输元素可以访问此元素中的介质片段。 在以下情况下无法访问媒体： (1) 如果元素类型为 ChangerSlot，则交换器中不存在槽 (例如，包含槽的杂志已被物理移除) 。 (2) 如果元素类型为 ChangerDrive，则驱动器损坏或已删除。 (3) 如果元素类型为 ChangerIEPort，则扩展更换器的插入/弹出端口。 |
|
AlternateVolumeID 成员中的备用卷信息有效。 |
|
元素处于异常状态。 有关详细信息，请查看 ExceptionCode 成员。 |
|
元素支持通过更换器的插入/弹出端口导出媒体。 |
|
元素包含一段媒体。
请注意，仅当元素类型为 ChangerDrive、ChangerSlot 或 ChangerTransport 时，此值才有效。 如果元素类型为 ChangerIEPort，则仅当 GET_CHANGER_PARAMETERS 的 Features0 成员包含CHANGER_REPORT_IEPORT_STATE时，此值才有效。 |
|
TargetID 成员中的 SCSI 目标 ID 有效。
仅当元素类型为 ChangerDrive 时，此值才有效。 |
|
此元素中的媒体由 运算符放置到该处。
仅当元素类型为 ChangerIEPort 时，此值才有效。 |
|
元素支持通过更换器的插入/弹出端口导入媒体。 |
|
元素中的媒体已翻转。
仅当同时包含ELEMENT_STATUS_SVALID时，此值才有效。 |
|
Lun 成员中的逻辑单元号有效。 仅当元素类型为 ChangerDrive 时，此值才有效。 |
|
Lun 和 TargetID 指示的地址处的驱动器与更换器本身位于不同的 SCSI 总线上。 |
|
SerialNumber 成员中的序列号有效。 |
|
PrimaryVolumeID 成员中的主卷信息有效。 |
|
SourceElement 成员和ELEMENT_STATUS_INVERT均有效。 |
ExceptionCode
指示元素处于异常状态的异常代码。 仅当 Flags 成员包含ELEMENT_STATUS_EXCEPT时，此成员才有效。 此成员可以是以下值之一。
TargetId
对于 SCSI 更换器，指定此元素地址处驱动器的 SCSI 目标 ID。 仅当 Element 结构的 ElementType 成员为 ChangerDrive 且 Flags 成员包含ELEMENT_STATUS_ID_VALID时，此成员才有效。
Lun
此元素地址处的驱动器的 SCSI 逻辑单元号。 仅当 Element 结构的 ElementType 成员为 ChangerDrive 且 Flags 成员包含ELEMENT_STATUS_LUN_VALID时，此成员才有效。
Reserved
保留供将来使用。 此成员的值必须为零。
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时，此成员才有效。
VendorIdentification[VENDOR_ID_LENGTH]
供应商标识符。
ProductIdentification[PRODUCT_ID_LENGTH]
产品标识符。
SerialNumber[SERIAL_NUMBER_LENGTH]
驱动器的序列号。
要求
| 最低受支持的客户端 | Windows XP |
| 最低受支持的服务器 | Windows Server 2003 |
| 标头 | winioctl.h (包括 Windows.h) |