Метод IDiscMaster::SetActiveDiscMasterFormat (imapi.h)
Задает текущий активный формат записи диска. Активный формат указывает как структуру содержимого промежуточного файла изображения (аудио/данные), так и интерфейс COM, который необходимо использовать для управления этим промежуточным изображением.
Синтаксис
HRESULT SetActiveDiscMasterFormat(
[in] REFIID riid,
[out] void **ppUnk
);
Параметры
[in] riid
IID активного формата.
[out] ppUnk
Указатель на COM-интерфейс для нового формата диска.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
Комментарии
Успешный вызов этого метода очищает содержимое текущего промежуточного изображения. Кроме того, он может изменить список поддерживаемых записей дисков. Это связано с тем, что не все средства записи поддерживают все форматы. Изменения в списке записей объявляются с помощью IDiscMasterProgressEvents::NotifyPnPActivity. Если выбранное в данный момент средство записи не входит в новый набор поддерживаемых устройств, оно больше не будет активным (аналогично состоянию после первого вызова Open). В этом случае приложение должно выбрать новое активное средство записи перед запуском записи.
MSDiscMasterObj поддерживает только следующие идентификаторы IID: IID_IRedbookDiscMaster (IRedbookDiscMaster) и IID_IJolietDiscMaster (IJolietDiscMaster). Если формат не задан, по умолчанию используется формат Joliet. Выбор формата master с помощью EnumDiscMasterFormats и этого метода лежит на каждом приложении.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi.h |
| Библиотека | Uuid.lib |
| DLL | Actxprxy.dll |