// 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 referenceNo description available.
This structure is passed to the ChangerQueryVolumeTags routine and is used to specify a search criterion for retrieving changer elements.
StartingElementDescribes the first element of the range to search for or to set in a structure of type CHANGER_ELEMENT.
ActionCodeIndicates the operation to perform. The Features0 member of GET_CHANGER_PARAMETERS indicates whether the changer supports a particular category of operation:
VolumeIDTemplateSpecifies 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.
Contains information that the IOCTL_CHANGER_QUERY_VOLUME_TAGS control code uses to determine the volume information to be retrieved.
StartingElementA CHANGER_ELEMENT structure that represents the starting element for which information is to be retrieved.
ActionCodeThe 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. |
VolumeIDTemplateThe 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.
IOCTL_CHANGER_QUERY_VOLUME_TAGS