IDirectSoundBuffer::Restore

HRESULT Restore();

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

В случае успешного завершения возвращает значение DS_OK. В противном случае возвращаемое значение может принимать одно из следующих значений:

• DSERR_BUFFERLOST — память, выделенная под буфер, освобождена и должна быть выделена заново.

• DSERR_INVALIDCALL — вызов данной функции недопустим при текущем состоянии объекта.

• DSERR_INVALIDPARAM — один или несколько аргументов метода имеют недопустимые значения.

• DSERR_PRIOLEVELNEEDED — вызывающее приложение имеет недостаточно высокий уровень приоритета для вызова данной функции.

Примечание

• Метод IDirectSoundBuffer::Restore позволяет восстановить память, назначенную аудио буферу объекта DirectSoundBuffer.

• Если приложение не имеет фокуса ввода вызов метода IDirectSoundBuffer::Restore может завершиться с ошибкой. Например, если приложение, имеющее фокус ввода, имеет уровень приоритета DSSCL_WRITEPRIMARY, ни одно другое приложение не может восстановить свои буфера. Аналогично, приложение с уровнем приоритета DSSCL_WRITEPRIMARY должно иметь фокус ввода, чтобы восстановить свой первичный аудио буфер.

• Как только DirectSound восстанавливает память, используемую под буфер, приложение может начать запись в него своей аудио информации. DirectSound не в состоянии восстановить содержимое аудио буферов. Приложение может получить извещение об освобождении своих буферов при вызове методов IDirectSoundBuffer::Lock или IDirectSoundBuffer::Play. В этом случае они возвращают значение DSERR_BUFFERLOST. Эту же информацию можно получить и с использованием метода IDirectSoundBuffer::GetStatus, проверив в возвращённом им значении статуса состояние флага DSBSTATUS_BUFFERLOST.

IDirectSoundBuffer::SetCurrentPosition

HRESULT SetCurrentPosition( DWORD dwNewPosition );

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

В случае успешного завершения возвращает значение DS_OK. В противном случае возвращаемое значение может принимать одно из следующих значений:

• DSERR_INVALIDCALL — вызов данной функции недопустим при текущем состоянии объекта.

• DSERR_INVALIDPARAM — один или несколько аргументов метода имеют недопустимые значения.

• DSERR_PRIOLEVELNEEDED — вызывающее приложение имеет недостаточно высокий уровень приоритета для вызова данной функции.

Аргументы

0. dwNewPosition — новая позиция воспроизведения, измеряемая смещением в байтах от начала аудио буфера.

Примечание

Метод IDirectSoundBuffer::SetCurrentPosition перемещает текущую позицию воспроизведения во вторичных аудио буферах.

Если буфер в момент вызова данного метода буфер воспроизводится, текущая позиция воспроизведения немедленно перемещается и воспроизведение продолжается с новой позиции. Если буфер в момент вызова метода IDirectSoundBuffer::SetCurrentPosition не воспроизводится, то при следующем вызове метода IDirectSoundBuffer::Play его воспроизведение начнётся с новой позиции.

IDirectSoundBuffer::SetFormat

HRESULT SetFormat( LPCWAVEFORMATEX lpcfxFormat );

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

В случае успешного завершения возвращает значение DS_OK. В противном случае возвращаемое значение может принимать одно из следующих значений:

• DSERR_BADFORMAT — указанный формат не поддерживается.

• DSERR_INVALIDCALL — вызов данной функции недопустим при текущем состоянии объекта.

• DSERR_INVALIDPARAM — один или несколько аргументов метода имеют недопустимые значения.

• DSERR_OUTOFMEMORY — недостаточно памяти для выполнения требуемой операции.

• DSERR_PRIOLEVELNEEDED — вызывающее приложение имеет недостаточно высокий уровень приоритета для вызова данной функции.

• DSERR_UNSUPPORTED — вызываемая функция в данный момент недоступна.

Аргументы

0. lpcfxFormat — указатель на объект структуры WAVEFORMATEX, описывающей новый формат первичного аудио буфера.

Примечание

Метод IDirectSoundBuffer::SetFormat устанавливает формат первичного аудио буфера приложения. Как только приложение получает фокус ввода, DirectSound устанавливает указанный формат первичного аудио буфера.

Если данный метод вызывается для настройки формата первичного аудио буфера, доступ к которому осуществляется на уровне приоритета DSSCL_WRITEPRIMARY, перед вызовом метода IDirectSoundBuffer::SetFormat работу с буфером следует приостановить. При осуществлении доступа к буферам с другими уровнями приоритета DirectSound сам останавливает работу с первичным буфером, изменяет его формат и возобновляет работу с ним. Приложению нет необходимости вмешиваться в этот процесс.

Если установленное в системе аппаратное обеспечение не поддерживает требуемый формат, DirectSound в некоторых может сам производить необходимые преобразования перед передачей сигнала в первичный буфер. Для проверки того, выполняется ли данная функция аппаратно или эмулируется средствами DirectSound, приложение может вызвать метод IDirectSoundBuffer::GetFormat для первичного аудио буфера и сравнить результат с форматом, переданным в методе SetFormat.

Если аппаратное обеспечение не поддерживает требуемый формат, а DirectSound не в состоянии его эмулировать, функция SetFormat выдаёт сообщение об ошибке.

Вызов данного метода невозможен в приложениях, для которых установлен уровень приоритета DSSCL_NORMAL. Этот метод не может применяться к вторичным аудио буферам. При возникновении необходимости изменить формат вторичного аудио буфера, приложение должно создать новый объект DirectSound, использующий новый формат. В настоящее время DirectSound не поддерживает форматы компрессии аудио данных.