2.2.4.13 NTMS_DRIVEINFORMATIONW Structure

  • Article

The NTMS_DRIVEINFORMATIONW structure describes the properties of a drive object, as a sequence of Unicode characters.

 typedef struct _NTMS_DRIVEINFORMATIONW {
   DWORD Number;
   DWORD State;
   NTMS_GUID DriveType;
   [string] wchar_t szDeviceName[64];
   [string] wchar_t szSerialNumber[32];
   [string] wchar_t szRevision[32];
   unsigned short ScsiPort;
   unsigned short ScsiBus;
   unsigned short ScsiTarget;
   unsigned short ScsiLun;
   DWORD dwMountCount;
   SYSTEMTIME LastCleanedTs;
   NTMS_GUID SavedPartitionId;
   NTMS_GUID Library;
   GUID Reserved;
   DWORD dwDeferDismountDelay;
 } NTMS_DRIVEINFORMATIONW;

Number: The number of the drive in the library. Some changers assign the number 0 to the first drive; other changers number the first drive 1.

State: A value from the NtmsDriveState enumeration that specifies the state of the drive.

DriveType: The identifier of the type object for the drive.

szDeviceName: A null-terminated sequence of Unicode UTF-16 characters specifying the name of the device path to access the drive.

szSerialNumber: The null-terminated serial number of the drive.

szRevision: A null-terminated sequence of Unicode UTF-16 characters specifying the revision of the drive.

ScsiPort: The SCSI [ANSI-131-1994] host adapter to which the drive is connected.

ScsiBus: The SCSI bus to which the drive is connected.

ScsiTarget: The SCSI target identifier of the drive.

ScsiLun: The SCSI logical unit identifier of the drive.

dwMountCount: The number of times the drive has had media mounted in it. If the drive supports the reporting of a unique serial number, this value MUST be the number of times the drive has been mounted since the RSM began managing this drive. If the drive does not support unique serial numbers, this member MUST indicate the number of mounts to all the drives at that mount location.

LastCleanedTs: A SYSTEMTIME structure specifying the last time the drive was cleaned.

SavedPartitionId: The partition identifier of the media in the drive. If this value is NULL and the drive is marked as full, the medium was loaded by a user, and MUST be identified and given a partition identifier.

Library: The identifier of the library that contains the drive.

Reserved: This parameter is unused. It MUST be 0 and MUST be ignored on receipt.

dwDeferDismountDelay: The minimum number of seconds that media MUST remain in the drive of an online library after a deferred dismount is performed; the default MUST be five minutes. This member MUST NOT apply to stand-alone libraries.