Export (0) Print
Expand All

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.

ValueMeaning
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

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft