Edit

CHANGER_SEND_VOLUME_TAG_INFORMATION structure (ntddchgr.h)

  • Article

This structure is passed to the ChangerQueryVolumeTags routine and is used to specify a search criterion for retrieving changer elements.

Syntax

typedef struct _CHANGER_SEND_VOLUME_TAG_INFORMATION {
  CHANGER_ELEMENT StartingElement;
  ULONG           ActionCode;
  UCHAR           VolumeIDTemplate[MAX_VOLUME_TEMPLATE_SIZE];
} CHANGER_SEND_VOLUME_TAG_INFORMATION, *PCHANGER_SEND_VOLUME_TAG_INFORMATION;

Members

StartingElement

Describes the first element of the range to search for or to set in a structure of type CHANGER_ELEMENT.

ActionCode

Indicates the operation to perform. The Features0 member of GET_CHANGER_PARAMETERS indicates whether the changer supports a particular category of operation:

  • Translate operations, also known as "searching operations", request that the target device search its volume tag information for elements that match the template passed to the device. Valid only if Features0 is set to CHANGER_VOLUME_SEARCH.
  • Assert operations define volume tag information for a single element. Valid only if Features0 is set to CHANGER_VOLUME_ASSERT.
  • Replace operations define volume tag information for a single element, overwriting any information previously defined. Valid only if Features0 is set to CHANGER_VOLUME_REPLACE.
  • Undefined operations clear previously defined volume tag information for a single element. Valid only if Features0 is set to CHANGER_VOLUME_UNDEFINE.

VolumeIDTemplate[MAX_VOLUME_TEMPLATE_SIZE]

Specifies the template to be used by the device to search for volume IDs. For a translate operation, the template can include the wildcard characters, asterisk (*) and question mark (?), to search for volumes that match the template. For other operations, the template specifies a single volume.

Requirements

Requirement Value
Header ntddchgr.h

See also

CHANGER_ELEMENT

ChangerQueryVolumeTags

GET_CHANGER_PARAMETERS

READ_ELEMENT_ADDRESS_INFO