Метод 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. Например, при изменении носителя на компакт-диске отправляется сообщение MCN для активации таких функций мультимедиа, как автозапуск. MCN включена по умолчанию. Вызовите этот метод, чтобы включить уведомления при отключении уведомлений с помощью IDiscRecorder2::D isableMcn.

Обратите внимание, что DisableMcn увеличивает количество ссылок при каждом вызове. Метод EnableMcn уменьшает количество. Устройство включается, если число ссылок равно нулю.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imapi2.h

См. также раздел

IDiscRecorder2

IDiscRecorder2::D isableMcn