IDirectSoundBuffer::Play

HRESULT Play( DWORD dwReserved1, DWORD dwReserved2, DWORD dwFlags );

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

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

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

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

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

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

Аргументы

0. dwReserved1 — аргумент зарезервирован для дальнейшего использования. Данный аргумент должен иметь нулевое значение.

1. dwReserved2 — аргумент зарезервирован для дальнейшего использования. Данный аргумент должен иметь нулевое значение.

2. dwFlags — флаги, определяющие режим воспроизведения буфера. Определены следующие флаги:

• DSBPLAY_LOOPING — режим циклического прослушивания. В этом режиме при достижении курсором воспроизведения конца данного буфера он немедленно перемещается в его начало и воспроизведение данных из буфера продолжается. Проигрывание содержимого буфера продолжается до тех пор, пока не будет остановлено приложением. Этот флаг должен быть установлен при воспроизведении содержимого первичного аудио буфера.

Примечание

Метод IDirectSoundBuffer::Play начинает воспроизведение содержимого аудио буфера с текущей позиции.

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

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

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

Перед вызовом данного метода для любого аудио буфера приложение должно вызвать метод IDirectSound::SetCooperativeLevel и установить в нём уровень приоритета. Обычно устанавливается уровень приоритета DSSCL_NORMAL. Если перед вызовом метода IDirectSoundBuffer::Play не был вызван метод IDirectSound::SetCooperativeLevel, то метод IDirectSoundBuffer::Play возвращает значение DS_OK, но аудио устройство не начинает воспроизведения пока не будет вызван метод IDirectSound::SetCooperativeLevel.