IDiscRecorder2::EnableMcn 方法 (imapi2.h)

为设备启用媒体更改通知 (MCN) 。

语法

HRESULT EnableMcn();

返回值

S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_FAIL
未知故障。

值:0x80004005

E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
设备未能在超时期限内接受命令。 这可能是由于设备进入了不一致状态,或者可能需要增加命令的超时值。

值:0xC0AA020D

HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE)
指定的句柄无效。

值:6

HRESULT_FROM_WIN32 (ERROR_DEV_NOT_EXIST)
指定的网络资源或设备不再可用。

值:55

E_IMAPI_RECORDER_LOCKED
上次操作期间与此记录器关联的设备已被独占锁定,导致此操作失败。

值:0xC0AA0210

注解

MCN 是 CD-ROM 设备驱动程序用于检测 CD-ROM 设备中的媒体更改和状态更改的方法。 例如,在 CD-ROM 设备中更改媒体时,将发送 MCN 消息以触发媒体功能,例如自动播放。 默认情况下,MCN 处于启用状态。 调用此方法以在使用 IDiscRecorder2::D isableMcn 禁用通知时启用通知。

请注意, 每次调用 DisableMcn 时,都会递增引用计数。 EnableMcn 方法递减计数。 当引用计数为零时,将启用设备。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

IDiscRecorder2

IDiscRecorder2::D isableMcn