IDiscMaster::EnumDiscRecorders 方法 (imapi.h)
检索活动光盘主控格式支持的所有光盘录制器的枚举器。
语法
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
parameters
[out] ppEnum
指向 IEnumDiscRecorders 枚举器的 指针的地址。
返回值
S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
注解
IEnumDiscRecorders 是标准 COM 枚举器,如 IEnumXXXX 中所述。 每次调用 Next 都会返回指向 IDiscRecorder 的指针数组。 每个记录器接口表示已与基础物理光盘记录器关联的单个可用记录器。
由于即插即用到达或离开,或者调用 SetActiveDiscMasterFormat,可用记录器的列表可能会更改。 当应用程序收到对 IDiscMasterProgressEvents::NotifyPnPActivity 的调用时,会通知应用程序这些更改。 发生更改时,应用程序应再次调用此方法以检索新的枚举器,因为每个枚举器都包含枚举时支持的设备的快照。
删除设备后,即使缺少基础物理设备,其指针和 IDiscRecorder 接口也必须保持有效。 在这种情况下, IDiscRecorder 上的操作或录制光盘的请求可能会返回IMAPI_E_DEVICE_NOTPRESENT。
调用此方法时 ,将更新 MaxWriteSpeed 属性。 默认设置为最高可用写入速度。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi.h |
Library | Uuid.lib |
DLL | Actxprxy.dll |