(转)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