Метод IDiscFormat2RawCD::SetWriteSpeed (imapi2.h)
Задает скорость записи диска.
Синтаксис
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Параметры
[in] RequestedSectorsPerSecond
Запрошенная скорость записи измеряется в секторах диска в секунду.
Значение 0xFFFFFFFF (-1) запрашивает, что запись выполняется с максимальной поддерживаемой скоростью для носителя. Это значение по умолчанию.
[in] RotationTypeIsPureCAV
Запрошенный тип управления скоростью вращения. Задайте значение VARIANT_TRUE, чтобы запросить тип управления постоянной угловой скоростью (CAV). Задайте значение VARIANT_FALSE, чтобы использовать другой тип управления скоростью вращения, который поддерживает средство записи. Значение по умолчанию — VARIANT_FALSE.
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Для запроса требуется выбрать текущее средство записи дисков.
Значение: 0xC0AA0003 |
|
Один или несколько аргументов являются недопустимыми.
Значение: 0x80070057 |
|
Недопустимый указатель.
Значение: 0x80004003 |
|
Неопределенный сбой.
Значение: 0x80004005 |
|
Не удалось выделить необходимую память.
Значение: 0x8007000E |
|
Устройству не удалось принять команду в течение периода ожидания. Это может быть вызвано тем, что устройство перешло в несогласованное состояние, или может потребоваться увеличить время ожидания для команды.
Значение: 0xC0AA020D |
|
Устройство сообщило о непредвиденных или недопустимых данных для команды.
Значение: 0xC0AA02FF |
|
Носитель вставляется вверх ногами.
Значение: 0xC0AA0204 |
|
Диск сообщил, что он находится в процессе подготовки. Повторите запрос позже.
Значение: 0xC0AA0205 |
|
На устройстве нет носителя.
Значение: 0xC0AA0202 |
|
В настоящее время форматируется носитель. Дождитесь завершения форматирования, прежде чем пытаться использовать носитель.
Значение: 0xC0AA0206 |
|
Диск сообщил, что он выполняет длительную операцию, например завершает запись. Диск может быть непригодным для использования в течение длительного периода времени.
Значение: 0xC0AA0207 |
|
Не удалось выполнить запись, так как диск не получил данные достаточно быстро, чтобы продолжить запись. Перемещение исходных данных на локальный компьютер, снижение скорости записи или включение параметра "буфер недостаточной свободы" может устранить эту проблему.
Значение: 0xC0AA0300 |
|
Носитель несовместим или имеет неизвестный физический формат.
Значение: 0xC0AA0203 |
|
Структура DVD отсутствует. Это может быть вызвано несовместимыми дисками и носителями.
Значение: 0xC0AA020E |
|
Устройство сообщило, что запрошенная страница режима (и тип) отсутствует.
Значение: 0xC0AA0201 |
|
Диск сообщил, что сочетание параметров, предоставленных на странице режима для команды MODE SELECT, не поддерживается.
Значение: 0xC0AA0208 |
|
Диск сообщил, что носитель защищен от записи.
Значение: 0xC0AA0209 |
|
Скорость носителя несовместима с устройством. Это может быть вызвано использованием носителя с более высокой или низкой скоростью, чем диапазон скоростей, поддерживаемый устройством.
Значение: 0xC0AA020F |
|
Указанный дескриптор недопустим.
Значение: 6 |
|
Указанный сетевой ресурс или устройство больше не доступны.
Значение: 55 |
|
Устройство, связанное с этим устройством записи во время последней операции, было заблокировано исключительно, что привело к сбою этой операции.
Значение: 0xC0AA0210 |
|
Поддерживается только пустой носитель CD-R/RW.
Значение: 0xC0AA0606 |
|
Поддерживается только пустой носитель CD-R/RW.
Значение: 0xC0AA0607 |
|
Недопустимое имя клиента.
Значение: 0xC0AA0604 |
|
Требуемый тип поворота не поддерживался диском, и тип поворота был скорректирован.
Значение: 0x00AA0005 |
|
Запрошенная скорость записи не поддерживается диском, и скорость была скорректирована.
Значение: 0x00AA0004 |
|
Запрошенная скорость записи и тип поворота не поддерживаются диском, и оба они были скорректированы.
Значение: 0x00AA0006 |
Комментарии
Этот метод задает скорость записи и тип элемента управления скоростью вращения для средства записи. Запрошенные значения могут отличаться от значений, установленных в средстве записи. Чтобы указать средство записи, вызовите метод IDiscFormat2RawCD::p ut_Recorder .
Если средство записи поддерживает запрошенную скорость записи, устройство диска использует запрошенное значение. Если средство записи не поддерживает запрошенную скорость записи, средство записи использует поддерживаемую скорость записи, которая ближе всего к запрошенным значениям. Свойство IDiscFormat2RawCD::get_CurrentWriteSpeed содержит значение, используемое регистратором.
Чтобы получить список скоростей записи, поддерживаемых средством записи и текущим носителем, вызовите метод IDiscFormat2RawCD::get_SupportedWriteSpeeds .
Если вы запрашиваете постоянную угловую скорость (CAV) для типа управления скоростью вращения, а средство записи не поддерживает cav, дисковое устройство использует другой тип управления скоростью вращения, который оно поддерживает. Свойство IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV указывает значение, используемое регистратором.
Чтобы получить запрошенные значения, вызовите методы IDiscFormat2RawCD::get_RequestedWriteSpeed и IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV .
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |
См. также раздел
IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV
IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV