iDiscRecorder 接口 (imapi.h)

IDiscRecorder 接口允许访问标记为活动光盘录制器的单个光盘记录器设备。 IMAPI 对象（如 MSDiscMasterObj ）维护活动光盘录制器。

IDiscRecorder 对象表示单个硬件设备，但可以有多个 IDiscRecorder 实例都引用同一硬件设备。 在这种情况下，请使用 OpenExclusive 访问该设备。

继承

IDiscRecorder 接口继承自 IUnknown 接口。 IDiscRecorder 还具有以下类型的成员：

方法

IDiscRecorder 接口具有以下方法。

IDiscRecorder：：Close 释放对光盘录制器的独占访问权限。 这会还原文件系统对驱动器的访问。
IDiscRecorder：：弹出 如果可能，解锁并弹出光盘录音机的托盘。
IDiscRecorder：：Erase 如果这是 CD-RW 光盘记录器，则尝试擦除 CD-RW 介质。 支持完全擦除和快速擦除。
IDiscRecorder：：GetBasePnPID 检索一个基 PnP 字符串，该字符串可用于按制造和型号一致地标识特定类型的设备。 应用程序可以使用字符串根据特定的记录器类型自定义其行为。
IDiscRecorder：：GetDisplayNames 检索可显示的记录器的格式化名称。 名称由设备的制造商和产品标识符组成。
IDiscRecorder：：GetPath 检索操作系统中设备的路径。 此路径应与显示名称结合使用，以完全标识可用的光盘录制器。
IDiscRecorder：：GetRecorderGUID 检索当前与记录器对象关联的物理光盘录制器的 GUID。
IDiscRecorder：：GetRecorderProperties 检索指向 IPropertyStorage 接口的指针。
IDiscRecorder：：GetRecorderState 检索光盘录制器状态。
IDiscRecorder：：GetRecorderType 确定光盘记录器是 CD-R 还是 CD-RW 类型设备。 这并不指示设备中当前插入的媒体类型。
IDiscRecorder：：OpenExclusive 打开光盘录制器进行独占访问。
IDiscRecorder：：QueryMediaInfo 检索有关当前装载的媒体的信息，例如媒体上使用的块总数。
IDiscRecorder：：QueryMediaType 检测当前插入到记录器中的媒体类型（如果有）。
IDiscRecorder：：SetRecorderProperties 接受具有应用程序希望更改的所有属性的 对象的 IPropertyStorage 指针。 支持稀疏设置。

注解

所有 IDiscRecorder 接口都可以在 IDiscRecorder 对象上使用，即使光盘录制器不是活动光盘录制器也是如此。 IMAPI 客户端不必先调用 IDiscMaster：：SetActiveDiscRecorder 。

要求

最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi.h