Метод IDiscFormat2Data::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 |
|
Не удалось выполнить запись, так как диск вернул сведения об ошибке, которые не удалось восстановить.
Значение: 0xC0AA0301 |
|
Запрошенный тип поворота не поддерживался диском, и тип поворота был скорректирован.
Значение: 0x00AA0005 |
|
Запрошенная скорость записи не поддерживается диском, и скорость была скорректирована.
Значение: 0x00AA0004 |
|
Запрошенная скорость записи и тип поворота не поддерживаются диском, и оба они были скорректированы.
Значение: 0x00AA0006 |
Комментарии
Этот метод задает скорость записи и тип элемента управления скоростью вращения для средства записи. Запрошенные значения могут отличаться от значений, установленных в средстве записи. Чтобы указать средство записи, вызовите метод IDiscFormat2Data::p ut_Recorder .
Если средство записи поддерживает запрошенную скорость записи, устройство диска использует запрошенное значение. Если средство записи не поддерживает запрошенную скорость записи, средство записи использует поддерживаемую скорость записи, которая ближе всего к запрошенным значениям. Свойство IDiscFormat2Data::get_CurrentWriteSpeed содержит значение, используемое регистратором.
Чтобы получить список скоростей записи, поддерживаемых средством записи и текущим носителем, вызовите метод IDiscFormat2Data::get_SupportedWriteSpeeds .
Если вы запрашиваете постоянную угловую скорость (CAV) для типа управления скоростью вращения, а средство записи не поддерживает cav, дисковое устройство использует другой тип управления скоростью вращения, который оно поддерживает. Свойство IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV указывает значение, используемое средство записи.
Чтобы получить запрошенные значения, вызовите методы IDiscFormat2Data::get_RequestedWriteSpeed и IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV .
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |
См. также раздел
IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV
IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV