(转)DSound开发常用的几个结构
WAVEFORMATEX
WAVEFORMATEX
{
WORD wFormatTag;
WORD nChannels;
DWORD nSamplesPerSec;
DWORD nAvgBytesPerSec;
WORD nBlockAlign;
WORD wBitsPerSample;
WORD cbSize;
};
这个结构定义了WAVE音频数据的格式。只有所有音频包含的一般格式信息包含在这个结构中,对于需要其它信息的格式,这个结构包含在其中并且作为第一个参数。
成员变量
wFormatTag
Wave声音格式。格式标签是微软为一些压缩算法注册的,完整的格式标签列表在mmreg.h中定义。对于单声道或者双声道PCM数据,这个数值必须是WAVE_FORMAT_PCM
nChannels
WAVE数据的声道数量。非立体声使用单声道,立体声使用双声道。
nSamplesPerSec
采样率,单位HZ。如果wFormatTag为WAVE_FORMAT_PCM,一般这个数值是8.0K、11.025K、22.05K、或者44.1K。对于非PCM格式,这个变量必须通过格式标签的厂家说明书计算。
nAvgBytesPerSec
平均数据传输速率。如果格式标签是WAVE_FORMAT_PCM,这个值必须等于年SamplesPerSec和BlockAlign的乘积。对于非PCM格式,这个变量必须通过格式标签的厂家说明书计算。
nBlockAlign
区块队列,单位字节。区块队列是对于格式来说最小的单元。如果格式是WAVE_FORMAT_PCM 或者 WAVE_FORMAT_EXTENSIBLE,这个数值必须等于nChannels和wBitsPerSample的乘积除以8。对于非PCM格式,这个变量必须通过格式标签的厂家说明书计算。
软件必须每次执行一个nBlockAlign字节的加倍。写入和从一个设备读取数据必须在一个区块的开始。
wBitsPerSample
每次采样的字节。如果格式标签是WAVE_FORMAT_PCM,这个值必须等于8或者16。对于非PCM格式,这个变量必须通过格式标签的厂家说明书计算。如果格式标签是WAVE_FORMAT_EXTENSIBLE,这个值可以是任何8的倍数。一些压缩方案不能定义这个值,所以可以为0。
cbSize
大小,单位字节。作为额外的格式信息挂接在WAVEFORMATEX结构的结果。这个信息可以被非PCM格式用来存储额外格式标签的属性。如果没有额外的信息,这个成员必须设置为0。对于WAVE_FORMAT_PCM格式,也仅对于这种格式,这个成员被忽略。
DSBUFFERDESC
DSBUFFERDESC
{
DWORD dwSize;
DWORD dwFlags;
DWORD dwBufferBytes;
DWORD dwReserved;
LPWAVEFORMATEX lpwfxFormat;
GUID guid3DAlgorithm;
};
这个结构描述了一个新缓冲区对象的属性。IDirectSound8::CreateSoundBuffer和DirectSoundFullDuplexCreate8函数使用。为了兼容DX7或者更早的DX,这个结构的早期版本DSBUFFERDESC1仍然在Dsound.h中存在。
成员变量
dwSize
结构的大小,单位字节。这个成员必须在结构体使用以前被定义。
dwFlags
定义缓冲区的兼容能力,下面的值可以被定义
Value |
Description |
DSBCAPS_CTRL3D |
缓冲区具有3D控制兼容性。不能和DSBCAPS_CTRLPAN绑定,而且不能和lpwfxFormat中为设置立体声格式的缓冲区所设置。 |
DSBCAPS_CTRLFREQUENCY |
可以改变频率 |
DSBCAPS_CTRLFX |
支持特效处理。缓冲区必须足够大,可以保持至少DSBSIZE_FX_MIN毫秒的数据。 |
DSBCAPS_CTRLPAN |
具有面板控制的兼容性。不能和DSBCAPS_CTRL3D标志位绑定 |
DSBCAPS_CTRLPOSITIONNOTIFY |
The buffer has position notification capability. See Remarks. |
DSBCAPS_CTRLVOLUME |
可以控制音量。 |
DSBCAPS_GETCURRENTPOSITION2 |
The IDirectSoundBuffer8::GetCurrentPositionmethod uses the new behavior of the play cursor. In DirectSound in DirectX 1, the play cursor was significantly ahead of the actual playing sound on emulated sound cards; it was directly behind the write cursor. Now, if the DSBCAPS_GETCURRENTPOSITION2 flag is specified, the application can get a more accurate play cursor. If this flag is not specified, the old behavior is preserved for compatibility. Note that this flag affects only emulated sound cards. If a DirectSound driver is present, the play cursor is accurate for DirectSound in all versions of DirectX. |
DSBCAPS_GLOBALFOCUS |
全局缓冲区标志。设置了这个标志位,如果用户切换焦点到其它程序,即使新的程序也使用DSound,程序也能继续播放它的缓冲区。一个例外情况是切换到的程序使用DSSCL_WRITEPRIMARY标志作为协调层级。这种情况下,其它程序的全局声音也是不能听到的。 |
DSBCAPS_LOCDEFER |
在播放的时候缓冲区可以被分配到硬件或者软件资源中。这个标志位只有使用声音管理的缓冲区才可以设置。 |
DSBCAPS_LOCHARDWARE |
缓冲区必须使用硬件混音。如果设备不支持硬件混音或者需求的硬件内存不可用,IDirectSound8::CreateSoundBuffer的方法会失败。程序必须保证有混音频道可以为缓冲区所使用,这种情况是不能保证的。如果DSBCAPS_LOCSOFTWARE和这个标志位都没被指定,缓冲区优先使用这个标志位。硬件缓冲区在64位操作系统中是不被支持的。 |
DSBCAPS_LOCSOFTWARE |
这个缓冲区必须在软件内存中,使用软件混音器,即使DSBCAPS_STATIC被指定和硬件资源可用的情况下也不例外。 |
DSBCAPS_MUTE3DATMAXDISTANCE |
The sound is reduced to silence at the maximum distance. The buffer will stop playing when the maximum distance is exceeded, so that processor time is not wasted. Applies only to software buffers. |
DSBCAPS_PRIMARYBUFFER |
The buffer is a primary buffer. If this value is not specified, a secondary sound buffer is created. Cannot be combined with DSBCAPS_CTRLFX. |
DSBCAPS_STATIC |
The buffer is placed in on-board hardware memory, if available. No error occurs if such memory is not available. This flag has no effect on cards using the PCI bus. Cannot be combined with DSBCAPS_CTRLFX. |
DSBCAPS_STICKYFOCUS |
TThe buffer has sticky focus. If the user switches to another application not using DirectSound, the application's normal buffers are muted, but sticky focus buffers are still audible. |
转自:http://blog.sina.com.cn/s/blog_4de8abbb01000atg.html
相关文章
- 编程体系结构(07):JavaEE之Web开发
- 给初入测试/开发程序员的几点建议,把困难当做猎物......
- 【Css】Css和Html常用设计实例参考笔记(自己开发项目用)
- Php开发ZendStudio常用快捷键大全
- Android开发工程师文集-Fragment,适配器,轮播图,ScrollView,Gallery 图片浏览器,Android常用布局样式
- Android开发工程师文集-Fragment,适配器,轮播图,ScrollView,Gallery 图片浏览器,Android常用布局样式
- Ubuntu20.04 通过DD命令克隆自动驾驶开发环境
- 【HarmonyOS】ArkTS Native开发——使用 system函数创建文件
- Java EE开发四大常用框架
- 《OpenGL ES 3.x游戏开发(下卷)》一2.4 展翅飞翔的雄鹰
- 《iOS 8开发指南(第2版)》——第1章,第1.6节iOS的常用开发框架
- 《iOS 8开发指南》——导读
- J2EE开发时的包命名规则,养成良好的开发习惯
- iOS开发常用第三方开源框架
- iOS开发CoreAnimation解读之三——几种常用Layer的使用解析
- 依赖注入及AOP简述(十)——Web开发中常用Scope简介 .
- Android之开发常用颜色
- 移动开发大全之 M1 macOS 上开始使用 .NET MAUI (含完整安装过程)
- 《Arduino开发实战指南:机器人卷》一3.5 常用电机驱动芯片介绍
- Python——项目开发中常用的精华Python库介绍与整理.
- Android 常用开发类库
- 【正点原子Linux连载】第五十章 Linux 内核定时器实验 -摘自【正点原子】I.MX6U嵌入式Linux驱动开发指南V1.0
- 【3.5】mysql常用开发规则30条
- Java开发 - SpringCache初体验
- iOS开发 - 抛开表面看本质之iOS常用架构(MVC,MVP,MVVM)
- JAVA日常开发中常用的日志记录方式,攒个赞好不好?
- 项目开发中常用的精华Python库介绍与整理
- Android服务开发——WebService
- 开发小技巧 navicate如何点击单元格显示全部的文本内容或通过图像查看内容
- 是德科技成功开发广泛的测试与测量产品
- java web开发中常用的协议的使用和java-web 常见的缓存技术