Edit

CHANGER_SEND_VOLUME_TAG_INFORMATION structure (winioctl.h)

  • Article

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[MAX_VOLUME_TEMPLATE_SIZE]

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

Requirement Value
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Header winioctl.h (include Windows.h)

See also

CHANGER_ELEMENT

IOCTL_CHANGER_QUERY_VOLUME_TAGS