Метод IDiscRecorder2::InitializeDiscRecorder (imapi2.h)
Связывает объект с указанным устройством диска.
Синтаксис
HRESULT InitializeDiscRecorder(
[in] BSTR recorderUniqueId
);
Параметры
[in] recorderUniqueId
Строка, содержащая уникальный идентификатор устройства.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Один или несколько аргументов являются недопустимыми.
Значение: 0x80070057 |
|
Значение в cchDest равно 0 или больше STRSAFE_MAX_CCH. |
|
Неопределенный сбой.
Значение: 0x80004005 |
|
Не удалось выделить необходимую память.
Значение: 0x8007000E |
|
Устройству не удалось принять команду в течение периода ожидания. Это может быть вызвано тем, что устройство перешло в несогласованное состояние, или может потребоваться увеличить время ожидания для команды.
Значение: 0xC0AA020D |
|
Устройство сообщило о непредвиденных или недопустимых данных для команды.
Значение: 0xC0AA02FF |
|
Носитель вставляется вверх ногами.
Значение: 0xC0AA0204 |
|
Диск сообщил, что он находится в процессе подготовки. Повторите запрос позже.
Значение: 0xC0AA0205 |
|
На устройстве нет носителя.
Значение: 0xC0AA0202 |
|
В настоящее время форматируется носитель. Дождитесь завершения форматирования, прежде чем пытаться использовать носитель.
Значение: 0xC0AA0206 |
|
Диск сообщил, что он выполняет длительную операцию, например завершает запись. Диск может быть непригодным для использования в течение длительного периода времени.
Значение: 0xC0AA0207 |
|
Не удалось выполнить запись, так как диск не получил данные достаточно быстро, чтобы продолжить запись. Перемещение исходных данных на локальный компьютер, снижение скорости записи или включение параметра "буфер недостаточной свободы" может устранить эту проблему.
Значение: 0xC0AA0300 |
|
Носитель несовместим или имеет неизвестный физический формат.
Значение: 0xC0AA0203 |
|
Структура DVD отсутствует. Это может быть вызвано несовместимыми дисками и носителями.
Значение: 0xC0AA020E |
|
Устройство сообщило, что запрошенная страница режима (и тип) отсутствует.
Значение: 0xC0AA0201 |
|
Диск сообщил, что сочетание параметров, предоставленных на странице режима для команды MODE SELECT, не поддерживается.
Значение: 0xC0AA0208 |
|
Диск сообщил, что носитель защищен от записи.
Значение: 0xC0AA0209 |
|
Скорость носителя несовместима с устройством. Это может быть вызвано использованием носителя с более высокой или низкой скоростью, чем диапазон скоростей, поддерживаемый устройством.
Значение: 0xC0AA020F |
|
Указанный дескриптор недопустим.
Значение: 6 |
|
Указанный сетевой ресурс или устройство больше не доступны.
Значение: 55 |
|
Устройство, связанное с этим устройством записи во время последней операции, было заблокировано исключительно, что привело к сбою этой операции.
Значение: 0xC0AA0210 |
Комментарии
Перед вызовом любого из методов этого интерфейса необходимо инициализировать средство записи.
Чтобы получить список устройств на компьютере и их уникальные идентификаторы, вызовите метод IDiscMaster2::get__NewEnum .
Этот метод не приведет к сбою на диске, который заблокирован исключительно. Однако если диск заблокирован исключительно, некоторые методы этого интерфейса могут возвращать E_IMAPI_RECORDER_LOCKED. Чтобы определить, кто имеет монопольный доступ, вызовите метод IDiscRecorder2::get_ExclusiveAccessOwner .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |