Интерфейс IDiscRecorder (imapi.h)
Интерфейс IDiscRecorder обеспечивает доступ к одному устройству записи дисков, помеченное как активное устройство записи дисков. Объект IMAPI, например MSDiscMasterObj , поддерживает активное средство записи дисков.
Объект IDiscRecorder представляет одно аппаратное устройство, но может существовать несколько экземпляров IDiscRecorder , ссылающихся на одно и то же аппаратное устройство. В этом случае для доступа к этому устройству используйте OpenExclusive .
Наследование
Интерфейс IDiscRecorder наследуется от интерфейса IUnknown . IDiscRecorder также имеет следующие типы элементов:
Методы
Интерфейс IDiscRecorder содержит следующие методы.
| IDiscRecorder::Close Освобождает монопольный доступ к дисковой записи. Это восстанавливает доступ файловой системы к диску. |
| IDiscRecorder::Eject По возможности разблокирует и извлекает лоток записывателя дисков. |
| IDiscRecorder::Erase Пытается стереть носитель CD-RW, если это средство записи дисков CD-RW. Поддерживаются как полное, так и быстрое стирание. |
| IDiscRecorder::GetBasePnPID Извлекает базовую строку PnP, которую можно использовать для согласованной идентификации определенного класса устройства по образцу и модели. Строка может использоваться приложениями для настройки их поведения в соответствии с конкретным типом средства записи. |
| IDiscRecorder::GetDisplayNames Извлекает форматируемое имя для средства записи, которое может быть отображено. Имя состоит из изготовителя и идентификатора продукта устройства. |
| IDiscRecorder::GetPath Извлекает путь к устройству в операционной системе. Этот путь следует использовать в сочетании с отображаемым именем, чтобы полностью идентифицировать доступное средство записи дисков. |
| IDiscRecorder::GetRecorderGUID Извлекает ИДЕНТИФИКАТОР GUID физического средства записи дисков, в настоящее время связанного с объектом средства записи. |
| IDiscRecorder::GetRecorderProperties Извлекает указатель на интерфейс IPropertyStorage. |
| IDiscRecorder::GetRecorderState Извлекает состояние средства записи дисков. |
| IDiscRecorder::GetRecorderType Определяет, является ли устройство записи дисков устройством типа CD-R или CD-RW. Это не указывает на тип носителя, который в настоящее время вставлен на устройство. |
| IDiscRecorder::OpenExclusive Открывает средство записи дисков для монопольного доступа. |
| IDiscRecorder::QueryMediaInfo Извлекает сведения о текущем подключенном носителе, например общее количество блоков, используемых на носителе. |
| IDiscRecorder::QueryMediaType Определяет тип носителя, вставленного в средство записи, если таковой есть. |
| IDiscRecorder::SetRecorderProperties Принимает указатель IPropertyStorage для объекта со всеми свойствами, которые приложение хочет изменить. Поддерживаются разреженные параметры. |
Комментарии
Все интерфейсы IDiscRecorder можно использовать в объекте IDiscRecorder , даже если средство записи дисков не является активным. Клиенту IMAPI не нужно сначала вызывать IDiscMaster::SetActiveDiscRecorder .
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi.h |