NTMS_DRIVEINFORMATIONA结构（ntmsapi.h）

[可移动存储管理器 自 Windows 7 和 Windows Server 2008 R2 起不再可用。

NTMS_DRIVEINFORMATION 结构定义特定于驱动器对象的属性。

语法

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;

成员

Number

库中驱动器的数目。 这是根据设备的驱动器编号系统设置零个或一个相对值。 一些换行器编号驱动器从零开始，一些更改器以 1 开头。

State

驱动器的状态。 这可以是以下值之一。

价值	意义
NTMS_DRIVESTATE_BEING_CLEANED	驱动器正在清理且不可用。
NTMS_DRIVESTATE_DISMOUNTABLE	如果为延迟卸载设置库，则介质可能保留在库的驱动器上卸载。 RSM 可以满足已加载和卸载驱动器的装载请求。
NTMS_DRIVESTATE_DISMOUNTED	驱动器中没有介质。
NTMS_DRIVESTATE_LOADED	介质装载在驱动器中，并加载以供读取和写入访问。
NTMS_DRIVESTATE_MOUNTED	介质已装载到驱动器中，但尚未准备好进行读取和写入访问。 这是在驱动器等待轴同步或将磁带介质加载到头机制时使用的临时状态。
NTMS_DRIVESTATE_UNLOADED	介质已被驱动器卸载，并已准备好打开。 此状态表示轴已停止或磁带介质已返回到磁带盒。

DriveType

包含驱动器属性的驱动器类型对象的唯一标识符。

szDeviceName[NTMS_DEVICENAME_LENGTH]

用于访问驱动器的设备的名称。 对于磁带驱动器，此驱动器包含设备名称 \.\tape0 或 \.\tape1。 其他设备提供 SCSI 磁盘驱动器的名称或文件系统的根目录（原始、NTFS、FAT 等）。

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

表示为字符串的驱动器的序列号。 不支持序列号的设备报告此成员的 NULL。

szRevision[NTMS_REVISION_LENGTH]

表示为字符串的驱动器的修订。

ScsiPort

驱动器连接到的 SCSI 主机适配器。

ScsiBus

驱动器连接到的 SCSI 总线。

ScsiTarget

驱动器的 SCSI 目标 ID。

ScsiLun

驱动器的 SCSI 逻辑单元 ID。

dwMountCount

驱动器已安装介质的次数。 如果驱动器支持报告唯一序列号，则此值是自安装驱动器以来装载的次数。 如果驱动器不支持报告序列号，则此成员反映到该位置的所有驱动器的装载数。

LastCleanedTs

上次清理驱动器的时间。

SavedPartitionId

驱动器中介质的分区标识符。 如果此值为 NULL 且驱动器已满，则媒体已由用户加载，需要分类。

Library

包含驱动器的库的唯一标识符。

Reserved

保留。

dwDeferDismountDelay

执行延迟卸载后，介质将保留在库的驱动器中的最小秒数。 默认值为 5 分钟。 此成员不适用于独立库。 此成员可写。

言论

NTMS_DRIVEINFORMATION 结构包含在 NTMS_OBJECTINFORMATION 结构中。

注意

ntmsapi.h 标头将NTMS_DRIVEINFORMATION定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
标头	ntmsapi.h

另请参阅

NTMS_OBJECTINFORMATION