CHANGER_ELEMENT structure (ntddchgr.h)
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 |