Edit

CHANGER_READ_ELEMENT_STATUS structure (ntddchgr.h)

  • Article

The CHANGER_READ_ELEMENT_STATUS structure is used in conjunction with the IOCTL_CHANGER_GET_ELEMENT_STATUS request to retrieve the status of all elements or the status of a specified number of elements of a particular type.

Syntax

typedef struct _CHANGER_READ_ELEMENT_STATUS {
  CHANGER_ELEMENT_LIST ElementList;
  BOOLEAN              VolumeTagInfo;
} CHANGER_READ_ELEMENT_STATUS, *PCHANGER_READ_ELEMENT_STATUS;

Members

ElementList

Specifies the element type and the number of elements of that type for which to report status in a structure of type CHANGER_ELEMENT_LIST. This member contains a list of structures of type CHANGER_ELEMENT. The ElementType member of each CHANGER_ELEMENT structure in this list can be assigned a value of ChangerDrive, ChangerSlot, ChangerTransport, ChangerIEPort, or AllElements.

VolumeTagInfo

Indicates, when TRUE, that volume tag information should be reported in addition to element status. When FALSE, it indicates that only element status should be reported. A volume tag can be a bar code or an application-defined value assigned using ChangerQueryVolumeTags. This member is applicable only if either CHANGER_BAR_CODE_SCANNER_INSTALLED or CHANGER_VOLUME_IDENTIFICATION is set in the Features0 member of the GET_CHANGER_PARAMETERS structure.

Requirements

Requirement Value
Header ntddchgr.h

See also

CHANGER_ELEMENT

CHANGER_ELEMENT_LIST

ChangerGetElementStatus

GET_CHANGER_PARAMETERS

IOCTL_CHANGER_GET_ELEMENT_STATUS