Метод IDiscMaster::RecordDisc (imapi.h)
Записывает промежуточное изображение на носитель в активном средстве записи диска.
Синтаксис
HRESULT RecordDisc(
[in] boolean bSimulate,
[in] boolean bEjectAfterBurn
);
Параметры
[in] bSimulate
Указывает, был ли записан носитель. Если этот параметр имеет значение TRUE, носитель в активном средстве записи дисков фактически не записывается. Вместо этого выполняется имитация записи. Симуляция является хорошей проверкой дискового диктофона, так как большинство операций выполняются как в реальном ожоге. Если этот параметр имеет значение FALSE, носитель в средстве записи фактически сгорает.
[in] bEjectAfterBurn
Указывает, следует ли извлекать носитель после ожога. Если этот параметр имеет значение TRUE, носитель извлекается. Если этот параметр имеет значение FALSE, носитель не извлекается.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
Комментарии
Этот метод возвращается после завершения записи, хотя обратные вызовы хода выполнения выполняются при регистрации с помощью метода ProgressAdvise . Любые ошибки приводят к возврату этого метода с небольшими или без корректирующих действий со стороны этого метода.
Данные промежуточного изображения недопустимы после вызова RecordDisc. Это позволяет приложению выполнять либо имитированное, либо фактическое сгорание носителя. В целях безопасности содержимое файла спрямки автоматически очищается после успешного завершения первого вызова этого метода. Чтобы снова записать диск, необходимо перепроставить его.
Метод RecordDisc предполагает работу с пустым носителем для аудио. В противном случае может потребоваться удалить носитель (например, носитель CD-RW на диске CD-RW). См. раздел IDiscRecorder::Erase.
Метод SetActiveDiscRecorder определяет наличие многосеансового диска IMAPI на активном диске после установки. Если это так, IMAPI автоматически переходит в многосеансовый режим. Если в многосеансовом режиме выполняется вызов RecordDisc, то тот же диск, который установил многосеансовый режим, должен находиться в активном средстве записи, иначе будет возвращен код ошибки IMAPI_E_WRONGDISC.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi.h |
| Библиотека | Uuid.lib |
| DLL | Actxprxy.dll |