Dtk::Burn::DOpticalDiscOperator类 参考

用于光盘操作的类, 负责操作光盘的数据刻录、镜像刻录、镜像导出、数据校验等 更多...

#include <dopticaldiscoperator.h>

类 Dtk::Burn::DOpticalDiscOperator 继承关系图:

Dtk::Burn::DOpticalDiscOperator 的协作图:

信号
void	jobStatusChanged (JobStatus status, int progress, QString speed, QStringList message)
	光盘的数据刻录、镜像刻录、镜像导出、数据校验任务的状态信息信号

Public 成员函数
void	setSpeed (int speed)
	设置刻录的速度, 通常不用设置
void	setVolumeName (const QString &name)
	设置光盘卷标名称, 光盘刻录后生效, 卷标名称可以为空
void	setCheckPrecision (double checkPrecision)
	设置光盘校验的精度, 通常不用设置
int	speed () const
	获取 DOpticalDiscOperator::setSpeed 设置的刻录速度
QString	volumeName () const
	获取 DOpticalDiscOperator::setVolumeName 设置的光盘卷标名称
double	checkPrecision () const
	获取 DOpticalDiscOperator::setCheckPrecision 设置的光盘校验的精度
DTK_CORE_NAMESPACE::DExpected< bool >	burn (const QString &stagePath, const BurnOptions &opts)
	开始光盘数据刻录, 刻录期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出
DTK_CORE_NAMESPACE::DExpected< bool >	erase ()
	开始擦除光盘（需要光盘介质支持被擦除的物理特性）, 擦除期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出
DTK_CORE_NAMESPACE::DExpected< bool >	checkmedia ()
	开始校验光盘数据, 校验期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出
DTK_CORE_NAMESPACE::DExpected< bool >	writeISO (const QString &isoPath)
	开始将 iso 镜像文件写入到光盘中， 写入的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出
DTK_CORE_NAMESPACE::DExpected< bool >	dumpISO (const QString &isoPath)
	开始将光盘已刻录的数据导出为 iso 镜像文件， 导出的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

属性
int	speed
QString	volumeName
double	checkPrecision

友元
DTK_CORE_NAMESPACE::DExpected< DOpticalDiscOperator * >	DOpticalDiscManager::createOpticalDiscOperator (const QString &dev, QObject *parent)

详细描述

用于光盘操作的类, 负责操作光盘的数据刻录、镜像刻录、镜像导出、数据校验等

成员函数说明

burn()

DExpected< bool > DOpticalDiscOperator::burn	(	const QString &	stagePath,
		const BurnOptions &	opts
	)

开始光盘数据刻录, 刻录期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

参数

[in]	stagePath	待刻录的目录路径, 目录中的所有文件将会被刻录（不包含目录本身）
[in]	opts	刻录选项, 可以设置刻录的文件系统等信息

返回

成功返回 true, 反之为 DError 对象, 可获取失败原因

checkmedia()

DExpected< bool > DOpticalDiscOperator::checkmedia

(

)

开始校验光盘数据, 校验期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

返回

成功返回 true, 反之为 DError 对象, 可获取失败原因

checkPrecision()

double DOpticalDiscOperator::checkPrecision

(

)

const

获取 DOpticalDiscOperator::setCheckPrecision 设置的光盘校验的精度

返回

光盘校验的精度

dumpISO()

DExpected< bool > DOpticalDiscOperator::dumpISO

(

const QString &

isoPath

)

开始将光盘已刻录的数据导出为 iso 镜像文件， 导出的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

参数

[in]

isoPath

导出的 iso 镜像文件的存储绝对路径

返回

成功返回 true, 反之为 DError 对象, 可获取失败原因

注解

对于数据刻录的光盘, 导出的文件数据只包含第一次刻录的文件

erase()

DExpected< bool > DOpticalDiscOperator::erase

(

)

开始擦除光盘（需要光盘介质支持被擦除的物理特性）, 擦除期间的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

返回

成功返回 true, 反之为 DError 对象, 可获取失败原因

jobStatusChanged

void DOpticalDiscOperator::jobStatusChanged ( JobStatus  status, int  progress, QString  speed, QStringList  message  )

signal

光盘的数据刻录、镜像刻录、镜像导出、数据校验任务的状态信息信号

参数

[out]	status	当前任务的状态（失败、未工作、正在工作、暂停、结束）
[out]	progress	当前任务的进度, 最小值为 0, 最大值为 100
[out]	speed	当前任务的光盘转速
[out]	message	当任务出现错误时的失败信息

setCheckPrecision()

void DOpticalDiscOperator::setCheckPrecision

(

double

checkPrecision

)

设置光盘校验的精度, 通常不用设置

参数

[in]

checkPrecision

光盘校验的精度

setSpeed()

void DOpticalDiscOperator::setSpeed

(

int

speed

)

设置刻录的速度, 通常不用设置

参数

[in]

speed

刻录的速度

setVolumeName()

void DOpticalDiscOperator::setVolumeName

(

const QString &

name

)

设置光盘卷标名称, 光盘刻录后生效, 卷标名称可以为空

参数

[in]

name

光盘卷标名称

speed()

int DOpticalDiscOperator::speed

(

)

const

获取 DOpticalDiscOperator::setSpeed 设置的刻录速度

返回

刻录速度

volumeName()

QString DOpticalDiscOperator::volumeName

(

)

const

获取 DOpticalDiscOperator::setVolumeName 设置的光盘卷标名称

返回

光盘卷标名称

writeISO()

DExpected< bool > DOpticalDiscOperator::writeISO

(

const QString &

isoPath

)

开始将 iso 镜像文件写入到光盘中， 写入的过程信息将通过信号 DOpticalDiscOperator::jobStatusChanged 被发出

参数

[in]

isoPath

待写入的 iso 镜像文件的绝对路径

返回

成功返回 true, 反之为 DError 对象, 可获取失败原因

---

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

• include/dtkburn/dopticaldiscoperator.h
• docs/dtkburn/dopticaldiscoperator.zh_CN.dox