Dsbpositionnotify

typedef struct {

DWORD dwOffset;

HANDLE hEventNotify;

} DSBPOSITIONNOTIFY, *LPDSBPOSITIONNOTIFY;

typedef const DSBPOSITIONNOTIFY *LPCDSBPOSITIONNOTIFY;

Переменные

0. dwOffset — смещение от начала буфера точки, в которой будет отмечено событие, или DSBPN_OFFSETSTOP.

1. hEventNotify — дескриптор события, отмечаемого при достижении курсором воспроизведения заданной точки в аудио буфере.

Примечание

Объект структуры DSBPOSITIONNOTIFY используется в методе IDirectSoundNotify::SetNotificationPositions.

Если в переменной dwOffset содержится значение DSBPN_OFFSETSTOP, то событие отмечается в случае прекращения воспроизведения или записи вследствие достижения конца буфера при отсутствии режима кольцевого воспроизведения или вызова приложением методов IDirectSoundBuffer::Stop или IDirectSoundCaptureBuffer::Stop.

Описание данной структуры содержится в файле заголовка dsound.h

Dsbufferdesc

typedef struct {

DWORD dwSize;

DWORD dwFlags;

DWORD dwBufferBytes;

DWORD dwReserved;

LPWAVEFORMATEX lpwfxFormat;

} DSBUFFERDESC, *LPDSBUFFERDESC;

typedef const DSBUFFERDESC *LPCDSBUFFERDESC;

Переменные

0. dwSize —размер структуры в байтах. Эта переменная должна быть инициализирована до первого обращения к объекту структуры.

1. dwFlags — определяет возможности создаваемого объекта DirectSoundBuffer. Является комбинацией следующих значений:

• DSBCAPS_CTRL3D — данный буфер представляет собой первичный или вторичный аудио буфер, способный работать с 3-мерным звуком.

• DSBCAPS_CTRLDEFAULT — буфер имеет настройки, используемые по умолчанию. Данный флаг эквивалентен одновременной установке флагов DSBCAPS_CTRLPAN, DSBCAPS_CTRLVOLUME и DSBCAPS_CTRLFREQUENCY.

• DSBCAPS_CTRLFREQUENCY — буфер может изменять частоту дискретизации.

• DSBCAPS_CTRLPAN — буфер способен панорамировать звук.

• DSBCAPS_CTRLPOSITIONNOTIFY — буфер способен информировать о позиции своего курсора.

• DSBCAPS_CTRLVOLUME — буфер позволяет управлять уровнем.

• DSBCAPS_GETCURRENTPOSITION2 — указывает на то, что метод IDirectSoundBuffer::GetCurrentPosition должен использовать расширенные возможности управления курсором буфера воспроизведения. В объектах DirectSound, создаваемых DirectX версии 1 курсор буфера воспроизведения существенно опережал текущую позицию воспроизводимого аудио сигнала эмулируемых звуковых карт и отставал от курсора буфера записи. Флаг DSBCAPS_GETCURRENTPOSITION2 позволяет приложению получить более корректную информацию о позиции курсора буфера воспроизведения. Если этот флаг не определён, то, для совместимости со старыми приложениями, используется прежний режим отображения позиции курсора. Данный флаг используется только в режиме эмуляции звуковых карт. При наличии драйвера DirectSound позиция курсора буфера воспроизведения корректно отображается во всех версиях DirectX.

• DSBCAPS_GLOBALFOCUS — создаётся глобальный аудио буфер. Если установлен данный флаг, то приложение, использующее DirectSound, может продолжать воспроизведение содержимого буфера после передачи фокуса ввода другому приложению даже в том случае, если новое приложение использует DirectSound. Из этого правила существует одно исключение: если новое приложение использует DirectSound с уровнем приоритета DSSCL_EXCLUSIVE или DSSCL_WRITEPRIMARY, то глобальные буфера других приложений заглушаются.

• DSBCAPS_LOCHARDWARE — для данного буфера будет использоваться аппаратное микширование даже в том случае, если не установлен флаг DSBCAPS_STATIC. Если устройство не поддерживает аппаратного микширования или на звуковой карте отсутствует необходимый объём памяти, вызов метода IDirectSound::CreateSoundBuffer завершиться с ошибкой. Поскольку возможность аппаратного микширования обеспечивается не всеми звуковыми картами, приложение должно проверить наличие этой возможности до вызова соответствующих функций.

• DSBCAPS_LOCSOFTWARE — размещает буфер в оперативной памяти и использует для него программное микширование даже в том случае, если установлен флаг DSBCAPS_STATIC и имеется возможность аппаратного микширования.

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

• DSBCAPS_PRIMARYBUFFER — указывает на то, что данные установки относятся к первичному аудио буферу. Если этот флаг не установлен, создаётся вторичный аудио буфер.

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

• DSBCAPS_STICKYFOCUS — изменяет поведение аудио буферов при перемещении фокуса ввода приложения. Этот флаг может быть установлен при вызове метода IDirectSound::CreateSoundBuffer. Установка данного флага приводит к тому, что приложение, использующее DirectSound, продолжает воспроизведение своего специальным образом оформленного аудио буфера при передаче пользователем фокуса ввода приложению не использующему DirectSound. Воспроизведение обычных аудио буферов при этом прекращается. Это позволяет прослушивать аудио информацию при работе в таких приложениях как Microsoft Word или Microsoft Excel. Однако в том случае, когда фокус ввода передаётся приложению, использующему DirectSound, прекращается воспроизведение всех буферов старого приложения.

0. dwBufferBytes — задаёт размер создаваемого буфера в байтах. При создании первичного аудио буфера эта переменная должна содержать нулевое значение. Для вторичных аудио буферов значение этой переменной должно лежать в пределах, определяемых величинами DSBSIZE_MIN и DSBSIZE_MAX, определёнными в файле заголовка Dsound.h.

1. dwReserved — зарезервировано для дальнейшего использования.

2. lpwfxFormat — указатель на объект структуры, содержащей описание формата аудио информации в буфере. Для установки формата первичного аудио буфера используется метод IDirectSoundBuffer::SetFormat.

Примечание

Объект структуры DSBUFFERDESC содержит описание параметров объекта DirectSoundBuffer, создаваемого методом IDirectSound::CreateSoundBuffer.

Флаги DSBCAPS_LOCHARDWARE и DSBCAPS_LOCSOFTWARE, устанавливаемые в переменной dwFlags являются необязательными и взаимоисключающими. Флаг DSBCAPS_LOCHARDWARE используется для размещения буфера в памяти звуковой карты, а флаг DSBCAPS_LOCSOFTWARE размещает его в оперативной памяти компьютера, если это возможно.

Эти же флаги определены в переменной dwFlags, являющейся членом структуры DSCAPS, где они определяют фактическое размещение объекта DirectSoundBuffer.

При создании первичного аудио буфера приложение должно поместить в переменную dwBufferBytes нулевое значение. DirectSound определит оптимальный размер буфера исходя из возможностей используемой звуковой карты. Для определения размера созданного первичного аудио буфера следует вызвать метод IDirectSoundBuffer::GetCaps.

Описание данной структуры содержится в файле заголовка dsound.h

DSCAPS

typedef {

DWORD dwSize;

DWORD dwFlags;

DWORD dwMinSecondarySampleRate;

DWORD dwMaxSecondarySampleRate;

DWORD dwPrimaryBuffers;

DWORD dwMaxHwMixingAllBuffers;

DWORD dwMaxHwMixingStaticBuffers;

DWORD dwMaxHwMixingStreamingBuffers;

DWORD dwFreeHwMixingAllBuffers;

DWORD dwFreeHwMixingStaticBuffers;

DWORD dwFreeHwMixingStreamingBuffers;

DWORD dwMaxHw3DAllBuffers;

DWORD dwMaxHw3DStaticBuffers;

DWORD dwMaxHw3DStreamingBuffers;

DWORD dwFreeHw3DAllBuffers;

DWORD dwFreeHw3DStaticBuffers;

DWORD dwFreeHw3DStreamingBuffers;

DWORD dwTotalHwMemBytes;

DWORD dwFreeHwMemBytes;

DWORD dwMaxContigFreeHwMemBytes;

DWORD dwUnlockTransferRateHwBuffers;

DWORD dwPlayCpuOverheadSwBuffers;

DWORD dwReserved1;

DWORD dwReserved2;

} DSCAPS, *LPDSCAPS;

typedef const DSCAPS *LPCDSCAPS;

Переменные

0. dwSize — размер структуры в байтах. Эта переменная должна быть инициализирована до первого обращения к объекту структуры.

1. dwFlags — определяет возможности устройства. Является комбинацией следующих значений:

• DSCAPS_CERTIFIED — драйвер был протестирован и сертифицирован корпорацией Microsoft.

• DSCAPS_CONTINUOUSRATE — аудио устройство может работать со всеми частотами дискретизации от dwMinSecondarySampleRate до dwMaxSecondarySampleRate. Обычно это означает, что реальная частота дискретизации выводимой информации находится в пределах 10 Гц от требуемой частоты дискретизации.

• DSCAPS_EMULDRIVER — для устройства не установлен драйвер DirectSound, поэтому он эмулируется стандартными функциями Windows. Это приводит к дополнительным временным затратам.

• DSCAPS_PRIMARY16BIT — аудио устройство способно работать с 16-разрядным первичным аудио буфером.

• DSCAPS_PRIMARY8BIT — аудио устройство способно работать с 8-разрядным первичным аудио буфером.

• DSCAPS_PRIMARYMONO — аудио устройство способно работать с первичными моно буферами.

• DSCAPS_PRIMARYSTEREO — аудио устройство способно работать с первичными стерео буферами.

• DSCAPS_SECONDARY16BIT — аудио устройство способно работать с аппаратно микшируемыми 16-разрядным вторичным аудио буферами.

• DSCAPS_SECONDARY8BIT — аудио устройство способно работать с аппаратно микшируемыми 8-разрядным вторичным аудио буферами.

• DSCAPS_SECONDARYMONO — аудио устройство способно работать с аппаратно микшируемыми вторичными моно буферами.

• DSCAPS_SECONDARYSTEREO — аудио устройство способно работать с аппаратно микшируемыми вторичными стерео буферами.

0. dwMinSecondarySampleRate и dwMaxSecondarySampleRate — минимальная и максимальная частота дискретизации, аппаратно поддерживаемая вторичными аудио буферами данного устройства.

1. dwPrimaryBuffers — количество поддерживаемых первичных аудио буферов. Эта величина всегда равняется 1.

2. dwMaxHwMixingAllBuffers — определяет общее число аудио буферов, которое может быть смешано аппаратно. Эта величина может быть меньше суммы величин dwMaxHwMixingStaticBuffers и dwMaxHwMixingStreamingBuffers, поскольку эти буфера могут разделять одно и то же физическое пространство в памяти звуковой карты.

3. dwMaxHwMixingStaticBuffers — определяет общее число статических аудио буферов устройства.

4. dwMaxHwMixingStreamingBuffers — определяет общее число потоковых аудио буферов устройства.

5. dwFreeHwMixingAllBuffers, dwFreeHwMixingStaticBuffers и dwFreeHwMixingStreamingBuffers — определяет незадействованные возможности устройства по микшированию буферов. Приложение может использовать эти величины для определения аппаратных ресурсов, которые могут быть использованы для создания вторичных аудио буферов. Вычитание полученных значений из соответствующих предельных значений позволяет определить объём уже задействованных ресурсов.

6. dwMaxHw3DAllBuffers, dwMaxHw3DStaticBuffers и dwMaxHw3DStreamingBuffers — описание возможностей устройства по созданию 3-мерного звука.

7. dwFreeHw3DAllBuffers, dwFreeHw3DStaticBuffers и dwFreeHw3DStreamingBuffers — описание незадействованных возможностей устройства по созданию 3-мерного звука.

8. dwTotalHwMemBytes — размер в байтах оперативной памяти, расположенной на звуковой карте, которая может быть использована для создания статических аудио буферов.

9. dwFreeHwMemBytes — размер в байтах оперативной памяти, расположенной на звуковой карте.

10. dwMaxContigFreeHwMemBytes — размер в байтах наибольшей свободной слитной области памяти, расположенной на звуковой карте.

11. dwUnlockTransferRateHwBuffers — характеризует скорость, измеряемую в килобайтах в секунду, с которой данные могут передаваться в аппаратно реализованный статический аудио буфер. Эта величина, наряду с объёмом передаваемой информации, определяет продолжительность вызова метода IDirectSoundBuffer::Unlock. Для программно реализованных буферов эта величина равна нулю, поскольку нет необходимости перемещать какие-либо данные.

12. dwPlayCpuOverheadSwBuffers — определяет процентную загрузку центрального процессора при микшировании программно реализованных буферов (расположенных в оперативной памяти компьютера). Эта величина зависит от типа используемой шины, типа процессора и его тактовой частоты. Эта величина равна нулю для аппаратно реализованных буферов, поскольку их микширование производится в звуковой карте.

13. dwReserved1 dwReserved2 — зарезервировано для дальнейшего использования.

Примечание

Объект структуры DSCAPS используется для передачи описания возможностей устройства DirectSound в метод IDirectSound::GetCaps.

Описание данной структуры содержится в файле заголовка dsound.h.