该类用于访问及操作设备驱动器（磁盘驱动器）更多...

#include <ddiskdrive.h>

类 Dtk::Mount::DDiskDrive 继承关系图:

Dtk::Mount::DDiskDrive 的协作图:

Public 槽
void	eject (const QVariantMap &options)
	从驱动器中弹出存储介质，仅对“具有可移动存储介质的驱动器”有意义，例如光驱

void	powerOff (const QVariantMap &options)
	对驱动器进行断电操作以便其可以从计算机中安全移除。若能操作陈宫，则说明没有任何进程在使用驱动器

void	setConfiguration (const QVariantMap &value, const QVariantMap &options)
	设置驱动器配置列表。会同时将配置信息存储到文件系统和驱动设备中

Public 成员函数
	~DDiskDrive ()
	析构函数

QString	path () const
	获取驱动设备的对象路径，形如 /org/freedesktop/UDisks/Drives/...

bool	canPowerOff () const
	查询驱动设备能否执行断电操作

QVariantMap	configuration () const
	查询驱动设备配置信息

QString	connectionBus () const
	查询驱动设备所连接的总线类型

bool	ejectable () const
	查询驱动设备是否可执行弹出操作，例如光驱是可弹出托盘的

QString	id () const
	获取驱动设备唯一标识符，通常情况下，驱动设备对象路径最后一段数据即为它

QString	media () const
	获取驱动设备当前存储媒介类型，在查询光驱当前光盘类型时十分有用

bool	mediaAvailable () const
	查询当前驱动设备内是否有存储媒介存在，通常用于查询光驱内是否有光盘

bool	mediaChangeDetected () const
	查询是否检测到媒介变更

QStringList	mediaCompatibility () const
	查询驱动设备所支持的物理存储介质的类型列表

bool	mediaRemovable () const
	查询驱动设备存储介质是否为可移动设备

QString	model () const
	查询驱动设备型号名称

bool	optical () const
	查询驱动设备是否为光驱设备

bool	opticalBlank () const
	查询光驱设备中光盘是否为空白光盘，该方法仅在 optical() 为 True 时有效

uint	opticalNumAudioTracks () const
	查询光盘中的音频轨道数量，该方法仅在 optical() 为 True 时有效

uint	opticalNumDataTracks () const
	查询光盘中数据轨道数量，该方法仅在 optical() 为 True 时有效

uint	opticalNumSessions () const
	查询光盘中会话数量，该方法仅在 optical() 为 True 时有效

uint	opticalNumTracks () const
	查询光盘中轨道数量，该方法仅在 optical() 为 True 时有效

bool	removable () const
	提示驱动设备或者其存储介质是否可移动

QString	revision () const
	查询驱动设备硬件版本

int	rotationRate () const
	查询设备转速

QString	seat () const
	查询驱动设备插入的插槽标识符

QString	serial () const
	查询驱动设备序列号

QString	siblingId () const
	一个标识符，非空情况下可用于判定一组设备是否是同一个驱动器

quint64	size () const
	获取驱动器或驱动器当前存储介质的容量大小

QString	sortKey () const
	用于对驱动设备排序的键值

quint64	timeDetected () const
	获取第一次检测到驱动器的时间

quint64	timeMediaDetected () const
	存储媒介检测到的时间

QString	vendor () const
	获取驱动器生产厂商名称

QString	WWN () const
	获取驱动器全局名称（World wide name）

Protected 成员函数
	DDiskDrive (const QString &path, QObject *parent=nullptr)

属性
QString	path

bool	canPowerOff

QVariantMap	configuration

QString	connectionBus

bool	ejectable

QString	id

QString	media

bool	mediaAvailable

bool	mediaChangeDetected

QStringList	mediaCompatibility

bool	mediaRemovable

QString	model

bool	optical

bool	opticalBlank

uint	opticalNumAudioTracks

uint	opticalNumDataTracks

uint	opticalNumSessions

uint	opticalNumTracks

bool	removable

QString	revision

int	rotationRate

QString	seat

QString	serial

QString	siblingId

quint64	size

QString	sortKey

quint64	timeDetected

quint64	timeMediaDetected

QString	vendor

QString	WWN

友元
DExpected< DDiskDrive * >	DDeviceManager::createDiskDrive (const QString &path, QObject *parent)

详细描述

该类用于访问及操作设备驱动器（磁盘驱动器）

成员函数说明

◆ canPowerOff()

bool DDiskDrive::canPowerOff ( ) const

查询驱动设备能否执行断电操作

返回: 是否可断电

返回值

True	可以断电
False	不可断电

◆ configuration()

QVariantMap DDiskDrive::configuration ( ) const

查询驱动设备配置信息

返回: 驱动设备配置信息表

◆ connectionBus()

QString DDiskDrive::connectionBus ( ) const

查询驱动设备所连接的总线类型

返回: 总线类型

◆ eject

void DDiskDrive::eject ( const QVariantMap & options )

slot

从驱动器中弹出存储介质，仅对“具有可移动存储介质的驱动器”有意义，例如光驱

参数

[in] options 除标准参数外暂未使用

◆ ejectable()

bool DDiskDrive::ejectable ( ) const

查询驱动设备是否可执行弹出操作，例如光驱是可弹出托盘的

返回: 是否可弹出

◆ id()

QString DDiskDrive::id ( ) const

获取驱动设备唯一标识符，通常情况下，驱动设备对象路径最后一段数据即为它

返回: 驱动设备唯一标识

参见: QString DDiskDrive::path() const

◆ media()

QString DDiskDrive::media ( ) const

获取驱动设备当前存储媒介类型，在查询光驱当前光盘类型时十分有用

返回: 存储媒介类型

◆ mediaAvailable()

bool DDiskDrive::mediaAvailable ( ) const

查询当前驱动设备内是否有存储媒介存在，通常用于查询光驱内是否有光盘

返回: 是否有存储媒介存在

◆ mediaChangeDetected()

bool DDiskDrive::mediaChangeDetected ( ) const

查询是否检测到媒介变更

返回: 是否检测到媒介变更

◆ mediaCompatibility()

QStringList DDiskDrive::mediaCompatibility ( ) const

查询驱动设备所支持的物理存储介质的类型列表

返回: 驱动设备支持的存储媒介类型列表

◆ mediaRemovable()

bool DDiskDrive::mediaRemovable ( ) const

查询驱动设备存储介质是否为可移动设备

返回: 存储介质是否为可移动设备

◆ model()

QString DDiskDrive::model ( ) const

查询驱动设备型号名称

返回: 驱动设备型号名称或空字符串

◆ optical()

bool DDiskDrive::optical ( ) const

查询驱动设备是否为光驱设备

返回: 是否为光驱设备

◆ opticalBlank()

bool DDiskDrive::opticalBlank ( ) const

查询光驱设备中光盘是否为空白光盘，该方法仅在 optical() 为 True 时有效

返回: 是否为空白光盘

参见: bool DDiskDrive::optical() const

◆ opticalNumAudioTracks()

uint DDiskDrive::opticalNumAudioTracks ( ) const

查询光盘中的音频轨道数量，该方法仅在 optical() 为 True 时有效

返回: 音轨数量

参见: bool DDiskDrive::optical() const

◆ opticalNumDataTracks()

uint DDiskDrive::opticalNumDataTracks ( ) const

查询光盘中数据轨道数量，该方法仅在 optical() 为 True 时有效

返回: 数据轨道数量

参见: bool DDiskDrive::optical() const

◆ opticalNumSessions()

uint DDiskDrive::opticalNumSessions ( ) const

查询光盘中会话数量，该方法仅在 optical() 为 True 时有效

返回: 光盘中会话数量

参见: bool DDiskDrive::optical() const

◆ opticalNumTracks()

uint DDiskDrive::opticalNumTracks ( ) const

查询光盘中轨道数量，该方法仅在 optical() 为 True 时有效

返回: 光盘中轨道数量

参见: bool DDiskDrive::optical() const

◆ path()

QString DDiskDrive::path ( ) const

获取驱动设备的对象路径，形如 /org/freedesktop/UDisks/Drives/...

返回: 驱动设备对象路径

◆ powerOff

void DDiskDrive::powerOff ( const QVariantMap & options )

slot

对驱动器进行断电操作以便其可以从计算机中安全移除。若能操作陈宫，则说明没有任何进程在使用驱动器

参数

[in] options 除标准参数外暂未使用

◆ removable()

bool DDiskDrive::removable ( ) const

提示驱动设备或者其存储介质是否可移动

返回: 是否为可移动设备

参见: bool DDiskDrive::mediaRemovable() const

◆ revision()

QString DDiskDrive::revision ( ) const

查询驱动设备硬件版本

返回: 驱动设备硬件版本或空字符串

◆ rotationRate()

int DDiskDrive::rotationRate ( ) const

查询设备转速

返回: 设备转速

返回值

-1	是旋转设备但转速未知
0	非旋转设备
rate	转速，单位为圈/分钟

◆ seat()

QString DDiskDrive::seat ( ) const

查询驱动设备插入的插槽标识符

返回: 插槽标识符

◆ serial()

QString DDiskDrive::serial ( ) const

查询驱动设备序列号

返回: 序列号或空字符串

◆ setConfiguration

void DDiskDrive::setConfiguration	(	const QVariantMap &	value,
		const QVariantMap &	options
	)

slot

设置驱动器配置列表。会同时将配置信息存储到文件系统和驱动设备中

参数

[in]	value	要设置的配置列表
[in]	options	除标准参数外暂未使用

参见: QVariantMap DDiskDrive::configuration() const

◆ siblingId()

QString DDiskDrive::siblingId ( ) const

一个标识符，非空情况下可用于判定一组设备是否是同一个驱动器

返回: 标识符或空字符串

◆ size()

quint64 DDiskDrive::size ( ) const

获取驱动器或驱动器当前存储介质的容量大小

返回: 容量大小

返回值

0	当 MediaChangeDetected 为 False 时

◆ sortKey()

QString DDiskDrive::sortKey ( ) const

用于对驱动设备排序的键值

返回: 排序标识

◆ timeDetected()

quint64 DDiskDrive::timeDetected ( ) const

获取第一次检测到驱动器的时间

返回: 驱动器检测到的时间，单位毫秒（197001010000）

◆ timeMediaDetected()

quint64 DDiskDrive::timeMediaDetected ( ) const

存储媒介检测到的时间

返回: 媒介检测时间

返回值

0	当无媒介存在的情况下

◆ vendor()

QString DDiskDrive::vendor ( ) const

获取驱动器生产厂商名称

返回: 生产厂商名称或空字符串

◆ WWN()

QString DDiskDrive::WWN ( ) const

获取驱动器全局名称（World wide name）

返回: WWM 或空字符串

该类的文档由以下文件生成:

include/dtkmount/ddiskdrive.h
docs/dtkmount/ddiskdrive.zh_CN.dox

Public 槽

Public 成员函数

Protected 成员函数

属性

友元

详细描述

成员函数说明

◆ canPowerOff()

◆ configuration()

◆ connectionBus()

◆ eject

◆ ejectable()

◆ id()

◆ media()

◆ mediaAvailable()

◆ mediaChangeDetected()

◆ mediaCompatibility()

◆ mediaRemovable()

◆ model()

◆ optical()

◆ opticalBlank()

◆ opticalNumAudioTracks()

◆ opticalNumDataTracks()

◆ opticalNumSessions()

◆ opticalNumTracks()

◆ path()

◆ powerOff

◆ removable()

◆ revision()

◆ rotationRate()

◆ seat()

◆ serial()

◆ setConfiguration

◆ siblingId()

◆ size()

◆ sortKey()

◆ timeDetected()

◆ timeMediaDetected()

◆ vendor()

◆ WWN()