CHANGER_ELEMENT structure (ntddchgr.h)

Article
04/01/2021

The CHANGER_ELEMENT structure contains a description of a changer element.

Syntax

typedef struct _CHANGER_ELEMENT {
  ELEMENT_TYPE ElementType;
  ULONG        ElementAddress;
} CHANGER_ELEMENT, *PCHANGER_ELEMENT;

Members

ElementType

Indicates the type of element. Can be one of the following values taken from the ELEMENT_TYPE enumeration.

AllElements

All elements of a changer, including its robotic transport, drives, slots, and IEport. AllElements is valid only in a ChangerGetElementStatus or ChangerInitializeElementStatus call.

ChangerTransport

The changer's robotic transport element, which is used to move media between IEports, slots, and drives.

ChangerSlot

A storage element, which is a slot in the changer in which media is stored when not mounted in a drive.

ChangerIEPort

An import/export element (IEport), which is a single or multiple-cartridge access port in some changers. An element is an IEport only if it is possible to move a piece of media from a slot to the IEport.

ChangerDrive

A data transfer element where data can be read from and written to media.

ChangerDoor

A mechanism that provides access to all media in a changer at one time (as compared to an IEport that provides access to one or more, but not all, media). For example, a large front door or a magazine that contains all media in the changer are elements of this type. ChangerDoor is valid only in a ChangerSetAccess call.

ChangerKeypad

The keypad or other input control on the front panel of a changer. ChangerKeypad is valid only in a ChangerSetAccess call.

ElementAddress

Indicates the element's zero-based address used by the system. A changer miniclass driver is responsible for translating this address to the device-specific address used by the changer.

Remarks

CHANGER_ELEMENT is used by both the changer class driver and a changer miniclass driver to describe a changer element.

On input, a changer miniclass driver must translate the zero-based address in ElementAddress to a device-specific address before accessing the element. On output, the driver must translate a device-specific address to the zero-based equivalent before filling in ElementAddress.

Requirements

Requirement	Value
Header	ntddchgr.h