Интерфейс IRawCDImageCreator (imapi2.h)

Используйте этот интерфейс для создания образа компакт-диска RAW, который будет использоваться при записи на компакт-диск в режиме "Диск за один раз" (DAO). Изображения, созданные с помощью этого интерфейса, можно записывать на компакт-диск с помощью интерфейса IDiscFormat2RawCD .

Чтобы создать экземпляр этого интерфейса, вызовите функцию CoCreateInstance . Use__uuidof(MsftRawCDImageCreator) для идентификатора класса и __uuidof(IRawCDImageCreator) для идентификатора интерфейса.

Наследование

Интерфейс IRawCDImageCreator наследуется от интерфейса IDispatch . IRawCDImageCreator также имеет следующие типы элементов:

Методы

Интерфейс IRawCDImageCreator содержит следующие методы.

IRawCDImageCreator::AddSpecialPregap Принимает предоставленный объект IStream и сохраняет связанный указатель для использования в качестве данных для предварительного разрыва для дорожки 1.
IRawCDImageCreator::AddSubcodeRWGenerator Позволяет добавлять пользовательский код R-W, предоставляемый IStream. Указанный объект должен иметь размер, равный количеству секторов в необработанном образе диска * 96 байт при создании окончательного образа.
IRawCDImageCreator::AddTrack Принимает предоставленный объект IStream и сохраняет указатель интерфейса в качестве следующей дорожки на изображении.
IRawCDImageCreator::CreateResultImage Создает окончательный объект IStream на основе текущих параметров.
IRawCDImageCreator::get_DisableGaplessAudio Извлекает текущее значение, указывающее, отключена ли запись "Gapless Audio". Это свойство по умолчанию имеет значение VARIANT_FALSE, которое отключает использование записи без пробелов между последовательными звуковыми дорожками.
IRawCDImageCreator::get_ExpectedTableOfContents Возвращает оглавление SCSI-формы для результирующего диска.
IRawCDImageCreator::get_LastUsedUserSectorInImage Извлекает общее количество используемых секторов на текущем носителе, включая любые издержки между существующими дорожками.
IRawCDImageCreator::get_MediaCatalogNumber Задает номер каталога мультимедиа (MCN) для всего звукового диска.
IRawCDImageCreator::get_NumberOfExistingTracks Извлекает количество существующих звуковых дорожек на носителе. (IRawCDImageCreator.get_NumberOfExistingTracks)
IRawCDImageCreator::get_ResultingImageType Извлекает значение, указывающее тип создаваемого файла изображения.
IRawCDImageCreator::get_StartingTrackNumber Извлекает начальный номер дорожки.
IRawCDImageCreator::get_StartOfLeadout Извлекает значение, определяющее LBA для начала leadout. Этот метод можно использовать, чтобы определить, можно ли записать изображение на носитель, сравнив его с LastPossibleStartOfLeadout для носителя.
IRawCDImageCreator::get_StartOfLeadoutLimit Извлекает текущее значение свойства StartOfLeadoutLimit. Это значение указывает, требуется ли полученное изображение для размещения на носителе с начальным значением StartOfLeadout, превышающим LBA или равным ей.
IRawCDImageCreator::get_TrackInfo Извлекает индексированное свойство, которое принимает значение LONG в диапазоне от 1 до 99 в качестве индекса, чтобы определить, к какому отслеживанию отправляет запрос пользователь. Затем возвращенный объект запрашивается или устанавливается для конкретного интересующего свойства для каждой дорожки.
IRawCDImageCreator::p ut_DisableGaplessAudio Задает значение, указывающее, отключена ли запись "Gapless Audio". Это свойство по умолчанию имеет значение VARIANT_FALSE, которое отключает использование записи без пробелов между последовательными звуковыми дорожками.
IRawCDImageCreator::p ut_MediaCatalogNumber Извлекает номер каталога мультимедиа (MCN) для всего звукового диска.
IRawCDImageCreator::p ut_ResultingImageType Задает значение, определяющее тип создаваемого файла изображения.
IRawCDImageCreator::p ut_StartingTrackNumber Задает начальный номер дорожки.
IRawCDImageCreator::p ut_StartOfLeadoutLimit Задает значение свойства StartOfLeadoutLimit.

Комментарии

Образы, созданные с помощью этого интерфейса, можно записать в постоянное хранилище для последующего использования или напрямую в интерфейс IDiscFormat2RawCD для записи на компакт-диск.

Dvd-носитель не поддерживает этот тип записи.

Этот интерфейс поддерживается в Windows Server 2003 с пакетом обновления 1 (SP1), Windows XP с пакетом обновления 2 (SP2) и Windows Vista с помощью пакета дополнительных компонентов Windows для хранилища. Все функции, предоставляемые этим пакетом обновления, изначально поддерживаются в Windows 7 и Windows Server 2008 R2.

Требования

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

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

IMAPI_CD_SECTOR_TYPE