NTMS_DRIVEINFORMATIONA structure (ntmsapi.h)
[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_DRIVEINFORMATIONA {
DWORD Number;
DWORD State;
NTMS_GUID DriveType;
CHAR szDeviceName[NTMS_DEVICENAME_LENGTH];
CHAR szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
CHAR szRevision[NTMS_REVISION_LENGTH];
WORD ScsiPort;
WORD ScsiBus;
WORD ScsiTarget;
WORD ScsiLun;
DWORD dwMountCount;
SYSTEMTIME LastCleanedTs;
NTMS_GUID SavedPartitionId;
NTMS_GUID Library;
GUID Reserved;
DWORD dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONA;
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.
DriveType
Unique identifier of the drive type object containing the attributes for the drive.
szDeviceName[NTMS_DEVICENAME_LENGTH]
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[NTMS_SERIALNUMBER_LENGTH]
Serial number for the drive represented as a string. Devices that do not support serial numbers report NULL for this member.
szRevision[NTMS_REVISION_LENGTH]
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.
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.
LastCleanedTs
Last time the drive was cleaned.
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.
Note
The ntmsapi.h header defines NTMS_DRIVEINFORMATION as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | ntmsapi.h |