CHANGER_SEND_VOLUME_TAG_INFORMATION structure

Contains information that the IOCTL_CHANGER_QUERY_VOLUME_TAGS control code uses to determine the volume information to be retrieved.

Syntax

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

Members

StartingElement

A CHANGER_ELEMENT structure that represents the starting element for which information is to be retrieved.

ActionCode

The action to be performed.

Value	Meaning
ASSERT_ALTERNATE 0x9	Define the alternate volume tag of a volume that currently has none defined. Requires that Features0 is CHANGER_VOLUME_ASSERT.
ASSERT_PRIMARY 0x8	Define the primary volume tag of a volume that currently has none defined. Requires that Features0 is CHANGER_VOLUME_ASSERT.
REPLACE_ALTERNATE 0xB	Replace the alternate volume tag with a new tag. Requires that Features0 is CHANGER_VOLUME_REPLACE.
REPLACE_PRIMARY 0xA	Replace the primary volume tag with a new tag. Requires that Features0 is CHANGER_VOLUME_REPLACE.
SEARCH_ALL 0x0	Search all defined volume tags. Requires that Features0 is CHANGER_VOLUME_SEARCH.
SEARCH_ALL_NO_SEQ 0x4	Search all defined volume tags, but ignore sequence numbers. Requires that Features0 is CHANGER_VOLUME_SEARCH.
SEARCH_ALT_NO_SEQ 0x6	Search only alternate volume tags, but ignore sequence numbers. Requires that Features0 is CHANGER_VOLUME_SEARCH.
SEARCH_ALTERNATE 02	Search only alternate volume tags. Requires that Features0 is CHANGER_VOLUME_SEARCH.
SEARCH_PRI_NO_SEQ 05	Search only primary volume tags but ignore sequence numbers. Requires that Features0 is CHANGER_VOLUME_SEARCH.
SEARCH_PRIMARY 0x1	Search only primary volume tags. Requires that Features0 is CHANGER_VOLUME_SEARCH.
UNDEFINE_ALTERNATE 0xD	Clear the alternate volume tag. Requires that Features0 is CHANGER_VOLUME_UNDEFINE.
UNDEFINE_PRIMARY 0xC	Clear the primary volume tag. Requires that Features0 is CHANGER_VOLUME_UNDEFINE.

 

VolumeIDTemplate

The template that the device uses to search for volume IDs. For search operations, the template can include wildcard characters to search for volumes that match the template. Supported wildcard characters include the asterisk (*) and question mark (?). For other operations, the template must specify a single volume.

Requirements

See also

CHANGER_ELEMENT

IOCTL_CHANGER_QUERY_VOLUME_TAGS

Send comments about this topic to Microsoft

Build date: 4/16/2013