IDiscRecorder2::D isableMcn 方法 (imapi2.h)
禁用设备的媒体更改通知 (MCN) 。
语法
HRESULT DisableMcn();
返回值
S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
返回代码 | 说明 |
---|---|
|
未知故障。
值:0x80004005 |
|
未能分配所需的内存。
值:0x8007000E |
|
设备未能在超时期限内接受命令。 这可能是由于设备进入了不一致状态,或者可能需要增加命令的超时值。
值:0xC0AA020D |
|
指定的句柄无效。
值:6 |
|
指定的网络资源或设备不再可用。
值:55 |
|
上次操作期间与此记录器关联的设备已被独占锁定,导致此操作失败。
值:0xC0AA0210 |
注解
MCN 是 CD-ROM 设备驱动程序用于检测 CD-ROM 设备中的媒体更改和状态更改的方法。 例如,在 CD-ROM 设备中更改媒体时,将发送 MCN 消息以触发媒体功能,例如自动播放。 若要禁用这些功能,请调用此方法。
若要启用通知,请调用 IDiscRecorder2::EnableMcn 方法。 如果应用程序意外崩溃或关闭,驱动程序会自动重新启用 MCN。
请注意,每次调用 DisableMcn 时,都会递增引用计数。 EnableMcn 方法递减计数。 当引用计数为零时,将启用设备。
要求
最低受支持的客户端 | Windows Vista、Windows XP 和 SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi2.h |