Метод IDiscMaster::EnumDiscRecorders (imapi.h)
Извлекает перечислитель для всех записей дисков, поддерживаемых активным форматом master диска.
Синтаксис
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
Параметры
[out] ppEnum
Адрес указателя на перечислитель IEnumDiscRecorders .
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
Комментарии
IEnumDiscRecorders — это стандартный перечислитель COM, как описано в документе IEnumXXXX. Каждый вызов next возвращает массив указателей на IDiscRecorder. Каждый интерфейс средства записи представляет одно доступное средство записи, уже связанное с базовым физическим дискозаписывателем.
Список доступных записей может измениться из-за прихода или отъезда Plug and Play или вызова SetActiveDiscMasterFormat. Приложение получает уведомление об этих изменениях при получении вызова IDiscMasterProgressEvents::NotifyPnPActivity. При изменении приложение должно снова вызвать этот метод, чтобы получить новый перечислитель, так как каждый перечислитель содержит snapshot устройств, поддерживаемых на момент перечисления.
При удалении устройства его указатель и интерфейс IDiscRecorder должны оставаться действительными, даже если базовое физическое устройство отсутствует. В этом случае операции с IDiscRecorder или запрос на запись диска могут возвращать IMAPI_E_DEVICE_NOTPRESENT.
Свойство MaxWriteSpeed обновляется при вызове этого метода. По умолчанию используется самая высокая доступная скорость записи.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi.h |
| Библиотека | Uuid.lib |
| DLL | Actxprxy.dll |