NTMS_DRIVEINFORMATION Structure
[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The NTMS_DRIVEINFORMATION structure defines properties specific to a drive object.
Syntax
typedef struct _NTMS_DRIVEINFORMATION {
DWORD Number;
DWORD State;
NTMS_GUID DriveType;
TCHAR szDeviceName[NTMS_DEVICENAME_LENGTH];
TCHAR szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
TCHAR szRevision[NTMS_REVISION_LENGTH];
WORD ScsiPort;
WORD ScsiBus;
WORD ScsiTarget;
WORD ScsiLun;
SYSTEMTIME LastCleanedTs;
DWORD dwMountCount;
NTMS_GUID SavedPartitionId;
NTMS_GUID Library;
GUID Reserved;
DWORD dwDeferDismountDelay;
} NTMS_DRIVEINFORMATION;
Members
Number
Number of the drive in the library. This is set zero or one relative the value based on the drive numbering system of the device. Some changers number drives beginning with zero, and some changers begin with one.State
State of the drive. This can be one of the following values.Value Meaning NTMS_DRIVESTATE_BEING_CLEANED The drive is being cleaned and is unavailable.
NTMS_DRIVESTATE_DISMOUNTABLE If a library is set for lazy dismounts, the medium might be left in the library's drive on a dismount. RSM can satisfy mount requests for loaded and dismounted drives.
NTMS_DRIVESTATE_DISMOUNTED No medium in the drive.
NTMS_DRIVESTATE_LOADED The medium is mounted in the drive and is loaded for read and write access.
NTMS_DRIVESTATE_MOUNTED The medium is mounted in the drive but is not ready for read and write access. This is a temporary state that is used while a drive is waiting for spindle synchronization or loading tape media into the head mechanism.
NTMS_DRIVESTATE_UNLOADED The medium has been dismounted by the drive and is ready to be opened. This state indicates that the spindle has stopped or a tape media has been returned to the tape cartridge.
DriveType
Unique identifier of the drive type object containing the attributes for the drive.szDeviceName
Name of the device used to access the drive. For a tape drive this contains the device name \\.\tape0 or \\.\tape1. Other devices provide the name of a SCSI disk drive or the root of a file system that currently has the device mounted (raw, NTFS, FAT and so forth).szSerialNumber
Serial number for the drive represented as a string. Devices that do not support serial numbers report NULL for this member.szRevision
Revision for the drive represented as a string.ScsiPort
SCSI host adapter to which the drive is connected.ScsiBus
SCSI bus to which the drive is connected.ScsiTarget
SCSI target ID for the drive.ScsiLun
SCSI logical unit ID for the drive.LastCleanedTs
Last time the drive was cleaned.dwMountCount
Number of times the drive has had a medium mounted to it. If the drive supports the reporting of a unique serial number, this value is the number of times the drive has been mounted since it was installed. If the drive does not support the reporting of serial numbers, this member reflects the number of mounts to all of the drives at that location.SavedPartitionId
Partition identifier of the medium that is in the drive. If this value is NULL and the drive is found to be full, the media was loaded by a user and needs to be classified.Library
Unique identifier of the library that contains the drive.Reserved
Reserved.dwDeferDismountDelay
Minimum number of seconds a medium will remain in a drive of a library after a deferred dismount has been performed. The default is 5 minutes. This member does not apply to stand-alone libraries. This member is writable.
Remarks
The NTMS_DRIVEINFORMATION structure is included in the NTMS_OBJECTINFORMATION structure.
Requirements
Minimum supported client |
Windows 2000 Professional |
Minimum supported server |
Windows 2000 Server |
End of client support |
Windows Vista |
End of server support |
Windows Server 2008 |
Header |
Ntmsapi.h |
See Also
Send comments about this topic to Microsoft
Build date: 6/9/2011