Метод IDiscFormat2Data::SetWriteSpeed (imapi2.h)

Статья
08/24/2023

Задает скорость записи диска.

Синтаксис

HRESULT SetWriteSpeed(
  [in] LONG         RequestedSectorsPerSecond,
  [in] VARIANT_BOOL RotationTypeIsPureCAV
);

Параметры

[in] RequestedSectorsPerSecond

Запрошенная скорость записи, измеряемая в секторах диска в секунду.

Значение 0xFFFFFFFF (-1) запрашивает, чтобы запись выполнялись с использованием самой быстрой поддерживаемой скорости для носителя. Это значение по умолчанию.

[in] RotationTypeIsPureCAV

Запрошенный тип управления скоростью вращения. Задайте значение VARIANT_TRUE для запроса типа управления вращательной скоростью с постоянной угловой скоростью (CAV). Задайте значение VARIANT_FALSE, чтобы использовать другой тип управления скоростью вращения, поддерживаемый регистратором. Значение по умолчанию — VARIANT_FALSE.

Возвращаемое значение

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата	Описание
E_IMAPI_RECORDER_REQUIRED	Для запроса требуется выбрать текущее средство записи дисков. Значение: 0xC0AA0003
E_INVALIDARG	Один или несколько аргументов недопустимы. Значение: 0x80070057
E_POINTER	Недопустимый указатель. Значение: 0x80004003
E_FAIL	Неуказанным сбоем. Значение: 0x80004005
E_OUTOFMEMORY	Не удалось выделить необходимую память. Значение: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	Устройству не удалось принять команду в течение времени ожидания. Это может быть вызвано тем, что устройство перешло в несогласованное состояние, или может потребоваться увеличить время ожидания для команды. Значение: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	Устройство сообщило непредвиденные или недопустимые данные для команды. Значение: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	Носитель вставляется вверх дном. Значение: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	Диск сообщил, что он находится в процессе подготовки. Повторите запрос позже. Значение: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	На устройстве нет носителя. Значение: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	В настоящее время форматируется носитель. Дождитесь завершения формата, прежде чем пытаться использовать носитель. Значение: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	Диск сообщил, что он выполняет длительную операцию, например завершает запись. Диск может быть непригодным для использования в течение длительного периода времени. Значение: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	Сбой записи, так как диск не получил данные достаточно быстро, чтобы продолжить запись. Эта проблема может быть решена при перемещении исходных данных на локальный компьютер, снижении скорости записи или включении параметра "недостаточно свободного буфера". Значение: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Носитель несовместим или имеет неизвестный физический формат. Значение: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	Структура DVD отсутствует. Это может быть вызвано несовместимыми используемыми дисками или средой. Значение: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Устройство сообщило, что запрошенная страница режима (и тип) отсутствует. Значение: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	Диск сообщил, что сочетание параметров, предоставленных на странице режима для команды MODE SELECT, не поддерживается. Значение: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	Диск сообщил, что носитель защищен от записи. Значение: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	Скорость носителя несовместима с устройством. Это может быть вызвано использованием носителя с более высокой или более низкой скоростью, чем диапазон поддерживаемых устройством скоростей. Значение: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	Указанный дескриптор недопустим. Значение: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	Указанный сетевой ресурс или устройство больше не доступны. Значение: 55
E_IMAPI_RECORDER_LOCKED	Устройство, связанное с этим устройством записи во время последней операции, было заблокировано исключительно, что привело к сбою этой операции. Значение: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	Не удалось выполнить запись, так как диск вернул сведения об ошибке, которые не удалось восстановить. Значение: 0xC0AA0301
S_IMAPI_ROTATIONADJUSTED	Запрошенный тип поворота не поддерживался диском, и тип поворота был скорректирован. Значение: 0x00AA0005
S_IMAPI_SPEEDADJUSTED	Запрошенная скорость записи не поддерживается диском, и скорость была скорректирована. Значение: 0x00AA0004
S_IMAPI_BOTHADJUSTED	Запрошенная скорость записи и тип поворота не поддерживаются диском, и оба они были скорректированы. Значение: 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