CHANGER_SEND_VOLUME_TAG_INFORMATION - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntddchgr.h

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;
View the official Windows Driver Kit DDI reference
// winioctl.h

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;
View the official Win32 API reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ns-ntddchgr-_changer_send_volume_tag_information)

_CHANGER_SEND_VOLUME_TAG_INFORMATION structure

Description

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

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:

VolumeIDTemplate

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.

See also

CHANGER_ELEMENT

ChangerQueryVolumeTags

GET_CHANGER_PARAMETERS

READ_ELEMENT_ADDRESS_INFO


Win32 API reference (ns-winioctl-changer_send_volume_tag_information)

CHANGER_SEND_VOLUME_TAG_INFORMATION structure

Description

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

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.

See also

CHANGER_ELEMENT

IOCTL_CHANGER_QUERY_VOLUME_TAGS