IDiscRecorder2::EnableMcn 方法 (imapi2.h)

啟用裝置的媒體變更通知 (MCN) 。

Syntax

HRESULT EnableMcn();

傳回值

成功時會傳回S_OK,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
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