3.2Dsound的buffer对象(DirectSound Buffers)
在存储和播放几个音频流的时候，你的应用程序要给每一个音频流都要创建一个辅助缓冲区（buffer）对象。
辅助缓冲区可以和应用程的生命期一样的长，也可以在不需要的时候销毁。辅助缓冲区可以是一个包含了整个声音数据的静态缓冲区，也是可以只包含声音数据的一部份，然后再播放时不断更新数据的流缓冲区。为了限制内存开销，在播放比较长的声音文件时要采用流缓冲区，这些缓冲区只包含几秒钟的数据量。
你可以通过同时播放几个辅助缓冲区中的声音来对他们进行混音，至于同时可以播放几个辅助缓冲区则有硬件设备的性能决定。
辅助缓冲区的格式并不完全一样，一般用来描述缓冲格式的参数如下
Format，缓冲区的format必须要所播放音频的waveformat一致。
Controls，不同的缓冲区的控制参数的值可以不一样，比如音量，频率，以及在不同方向的移动，当创建buffer时，你就要指定你需要的控制参数的值，例如，不要为一个不支持3D的音频创建一个3D缓冲区
Location，你创建的缓冲区可以在硬件管理的内存中，也可以在软件管理的内存中，当然，硬件缓冲区比软件缓冲区速度要快。
你可以调用IDirectSound8::CreateSoundBuffer函数来创建一个缓冲区（buffer）对象。这个函数返回一个指向IDrectSoundBuffer接口的指针，通过这个接口，应用程序可以获取
IDirectSoundBuffer8 interface.
下面的一段代码演示了如何创建一个辅助缓冲区，并且返回一个IDirectSoundBuffer8接口
HRESULT CreateBasicBuffer(LPDIRECTSOUND8 lpDirectSound, LPDIRECTSOUNDBUFFER8* ppDsb8)
{
WAVEFORMATEX wfx;
DSBUFFERDESC dsbdesc;
LPDIRECTSOUNDBUFFER pDsb = NULL;
HRESULT hr;
// Set up WAV format structure.
memset(&wfx, 0, sizeof(WAVEFORMATEX));
wfx.wFormatTag = WAVE_FORMAT_PCM;
wfx.nChannels = 2;
wfx.nSamplesPerSec = 22050;
wfx.nBlockAlign = 4;
wfx.nAvgBytesPerSec = wfx.nSamplesPerSec * wfx.nBlockAlign;
wfx.wBitsPerSample = 16;
// Set up DSBUFFERDESC structure.
memset(&dsbdesc, 0, sizeof(DSBUFFERDESC));
dsbdesc.dwSize = sizeof(DSBUFFERDESC);
dsbdesc.dwFlags =
DSBCAPS_CTRLPAN | DSBCAPS_CTRLVOLUME | DSBCAPS_CTRLFREQUENCY; // 流buffer
dsbdesc.dwBufferBytes = 3 * wfx.nAvgBytesPerSec;
dsbdesc.lpwfxFormat = &wfx;
// Create buffer.
hr = lpDirectSound->CreateSoundBuffer(&dsbdesc, &pDsb, NULL);
if (SUCCEEDED(hr))
{
hr = pDsb->QueryInterface(IID_IDirectSoundBuffer8, (LPVOID*) ppDsb8);
pDsb->Release();
}
return hr;
}
这个例子中创建了一个可以持续播放3秒钟的流缓冲区，如果你要创建静态的缓冲区，你就要创建的buffersize正好能够容下你的音频数据即可。
如果缓冲区的位置没有指定，DirectSound在条件允许的情况下将你的缓冲区设置为硬件控制，因为硬件缓冲区的混音是通过声卡的加速器来进行的，受应用程序的影响较小。
如果你想自己控制你创建的缓冲区（buffer）的位置，那么你一定要将DSBUFFERDESC中的 dsbdesc.dwFlags成员变量设置为DSBCAPS_LOCHARDWARE或者设置为DSBCAPS_LOCSOFTWARE,如果设置为DSBCAPS_LOCHARDWARE，此时硬件设备的资源不足时，缓冲区创建失败。
如果你想使用DirectSound的管理声音的特性，那么你创建缓冲区的时候一定要设置DSBCAPS_LOCDEFER标志，这个标志表示只有在播放的时候才分配内存，更多的细节，你可以参考动态的声音管理一节。
你可以通过IDirectSoundBuffer8::GetCaps方法来探明已经存在的缓冲区，并且可以检查该buffer的dwFlags设置情况。
缓冲区对象属于创建它的设备对象。当设备对象销毁时，它所创建的buffer对象也全部被销毁，没法被引用了。
你可以通过IDirectSound8::DuplicateSoundBuffer同时创建两个或者多个包含相同数据的辅助缓冲区，当然不允许复制主缓冲区。因为复制的缓冲区和原始的缓冲区共享内存，改变复制的缓冲区的数据的同时，也改变了原始缓冲区的内容。
下面我们看看buffer的控制属性
当你创建了缓冲区的时候，你的应用程序设置该缓冲区的控制属性，这是由DSBUFFERDESC结构的dwFlags成员来控制的。
下面我们来看看dwFlags的取值
DSBCAPS_CTRL3D 表示声音可以在3个方向上进行移动
DSBCAPS_CTRLFX ，表示可以在缓冲区中添加特技
DSBCAPS_CTRLFREQUENCY ,表示声音的频率可以被改动
DSBCAPS_CTRLPAN,表示声音可以从左声道被移动到右声道
DSBCAPS_CTRLPOSITIONNOTIFY，可以在buffer中设置通知的位置。
DSBCAPS_CTRLVOLUME，声音的大小可以被改变。
注意，有些标志位的组合是不允许的，具体的信息可以参见DSBUFFERDESC结构。
为了使得你的声卡更好的工作，你最好改变你应用程序用到的几个控制属性，其他的属性最好采用DirectSound来默认的设置。
DirectSound通过控制属性来判断是否可以在硬件设备上分配缓冲区。例如，一个设备可能支持硬件缓冲区，但是不支持控制pan，此时，当DSBCAPS_CTRLVOLUME标志没有设置的时候，DirectSound就可以使用硬件加速。
如果你的应用程序想调用buffer不支持的控制项，那么调用就会失败，例如，如果你想通过IDirectSoundBuffer8::SetVolume方法来设置音量，只有在创建buffer时设置了DSBCAPS_CTRLVOLUME标志这个函数调用才会成功。
当你创建的辅助缓冲区的控制标志位被设置为DSBCAPS_CTRL3D时，如果该buffer创建的位置由软件控制，那么你就可以给你创建的缓冲区指定一个3D你的声音的算法，缺省的情况下，采用的是HRTF（no head-related transfer function）算法来处理3D化声音。
下面我们看看如何两种buffer如何播放声音的，先看看静态的缓冲区吧。
包含全部音频数据的缓冲区我们称为静态的缓冲区，尽管，不同的声音可能会反复使用同一个内存buffer，但严格来说，静态缓冲区的数据只写入一次。
静态缓冲区的创建和管理和流缓冲区很相似，唯一的区别就是它们使用的方式不一样，静态缓冲区只填充一次数据，然后就可以play，然而，流缓冲区是一边play，一边填充数据。
给静态缓冲区加载数据分下面几个步骤
1， 调用IDirectSoundBuffer8::Lock函数来锁定所有的内存，你要指定你锁定内存中你开始写入数据的偏移位置，并且取回该偏移位置的地址。
2， 采用标准的数据copy方法，将音频数据复制到返回的地址。
3， 调用IDirectSoundBuffer8::Unlock.，解锁该地址。
下面的例子演示了上面提到的几个步骤，lpdsbStatic是指向静态buffer的指针
LPVOID lpvWrite;
DWORD dwLength;
if (DS_OK == lpdsbStatic->Lock(
0, // Offset at which to start lock.
0, // Size of lock; ignored because of flag.
&lpvWrite, // Gets address of first part of lock.
&dwLength, // Gets size of first part of lock.
NULL, // Address of wraparound not needed.
NULL, // Size of wraparound not needed.
DSBLOCK_ENTIREBUFFER)) // Flag.
{
memcpy(lpvWrite, pbData, dwLength);
lpdsbStatic->Unlock(
lpvWrite, // Address of lock start.
dwLength, // Size of lock.
NULL, // No wraparound portion.
0); // No wraparound size.
}
else
(
ErrorHandler(); // Add error-handling here.
}
将数据加载到缓冲区中就可以播放，调用IDirectSoundBuffer8::Play方法。如下：
lpdsbStatic->SetCurrentPosition(0);
HRESULT hr = lpdsbStatic->Play(
0, // Unused.
0, // Priority for voice management.
0); // Flags.
if (FAILED(hr))
(
ErrorHandler(); // Add error-handling here.
}
因为这个例子中没有设置DSBPLAY_LOOPING标志，当buffer到达最后时就会自动停止，你也可以调用IDirectSoundBuffer8::Stop方法来停止播放。如果你提前停止播放，播放光标的位置就会被保存下来，因此，例子中IDirectSoundBuffer8::SetCurrentPosition方法就是为了保证从头开始播放。
下面我们看看流缓冲区的用法
流缓冲区用来播放那些比较长的声音，因为数据比较长，没法一次填充到缓冲区中，一边播放，一边将新的数据填充到buffer中。
可以通过IDirectSoundBuffer8::Play函授来播放缓冲区中的内容，注意在该函数的参数中一定要设置DSBPLAY_LOOPING标志。
通过IDirectSoundBuffer8::Stop方法中断播放，该方法会立即停止缓冲区播放，因此你要确保所有的数据都被播放，你可以通过拖动播放位置或者设置通知位置来实现。
将音频流倒入缓冲区需要下面三个步骤
1确保你的缓冲区已经做好接收新数据的准备。你可以拖放播放的光标位置或者等待通知
2调用IDirectSoundBuffer8::Lock.函数锁住缓冲区的位置，这个函数返回一个或者两个可以写入数据的地址
3使用标准的copy数据的方法将音频数据写入缓冲区中
4 IDirectSoundBuffer8::Unlock.，解锁
IDirectSoundBuffer8：：Lock可能返回两个地址的原因在于你锁定内存的数量是随机的，有时你锁定的区域正好包含buffer的起始点，这时，就会给你返回两个地址，举个例子吧
假设你锁定了30,000字节，偏移位置为20，000字节，也就是开始位置，如果你的缓冲区的大小为40，000字节，此时就会给你返回四个数据
1内存地址的偏移位置20，000，
2从偏移位置到buffer的最末端的字节数，也是20，000，你要在第一个地址写入20，000个字节的内容
3偏移量为0的地址
4从起始点开始的字节数，也就是10，000字节，你要将这个字节数的内容写入第二个地址。
如果不包含零点，最后两个数值为NULL和0，
当然，你也有可能锁定buffer的全部内存，建议你在播放的时候不要这么做，通过你只是更新所有buffer中的一部份，例如，你可能在播放广标到达1/2位置前要将第一个1/4内存更新成新的数据，你一定不要更新play光标和Write光标间的内容。
BOOL AppWriteDataToBuffer(
LPDIRECTSOUNDBUFFER8 lpDsb, // The buffer.
DWORD dwOffset, // Our own write cursor.
LPBYTE lpbSoundData, // Start of our data.
DWORD dwSoundBytes) // Size of block to copy.
{
LPVOID lpvPtr1;
DWORD dwBytes1;
LPVOID lpvPtr2;
DWORD dwBytes2;
HRESULT hr;
// Obtain memory address of write block. This will be in two parts
// if the block wraps around.
hr = lpDsb->Lock(dwOffset, dwSoundBytes, &lpvPtr1,
&dwBytes1, &lpvPtr2, &dwBytes2, 0);
// If the buffer was lost, restore and retry lock.
if (DSERR_BUFFERLOST == hr)
{
lpDsb->Restore();
hr = lpDsb->Lock(dwOffset, dwSoundBytes,
&lpvPtr1, &dwBytes1,
&lpvPtr2, &dwBytes2, 0);
}
if (SUCCEEDED(hr))
{
// Write to pointers.
CopyMemory(lpvPtr1, lpbSoundData, dwBytes1);
if (NULL != lpvPtr2)
{
CopyMemory(lpvPtr2, lpbSoundData+dwBytes1, dwBytes2);
}
// Release the data back to DirectSound.
hr = lpDsb->Unlock(lpvPtr1, dwBytes1, lpvPtr2,
dwBytes2);
if (SUCCEEDED(hr))
{
// Success.
return TRUE;
}
}
// Lock, Unlock, or Restore failed.
return FALSE;
}
下面我们看看如何控制播放的属性
你可以通过IDirectSoundBuffer8::GetVolume and IDirectSoundBuffer8::SetVolume函数来获取或者设置正在播放的音频的音量的大小。
如果设置主缓冲区的音量就会改变声卡的音频的声量大小。音量的大小，用分贝来表示，一般没法来增强缺省的音量，这里要提示一下，分贝的增减不是线形的，减少3分贝相当于减少1/2的能量。最大值衰减100分贝几乎听不到了。
通过IDirectSoundBuffer8::GetFrequency and IDirectSoundBuffer8::SetFrequency方法可以获取设置音频播放的频率，主缓冲区的频率不允许改动，
通过 IDirectSoundBuffer8::GetPan and IDirectSoundBuffer8::SetPan函数可以设置音频在左右声道播放的位置，具有3D特性的缓冲区没法调整声道。
下面要看看混音。
如果辅助缓冲区中的音频同时播放就会主缓冲区自动的混音，在WDM驱动模式下，混音的工作由核心混音器来完成，不同的辅助缓冲区可能具有不同的WAV格式（例如，不同的采样频率），在必要的时候，辅助缓冲区的格式要转换成主缓冲区，或者核心混音器的格式。
在VXD驱动模式下，如果你的辅助缓冲区都采用相同的音频格式，并且硬件的音频格式也和你的音频格式匹配，此时，混音器不用作任何的转换。你的应用程序可以创建一个主缓冲区，然后通过IDirectSoundBuffer8::SetFormat来设置硬件的输出格式。要注意，只有你的协作度一定要是Priority Cooperative Level.，并且，一定要创建辅助缓冲区前设置主缓冲区，DirectSound会将你的设置保存下来。
在WDM模式下，对主缓冲区的的设置没有作用，因为主缓冲区的格式是由内核混音器来决定的。
循环播放；
Directsound并不支持在buffer内部的循环或者声音的一部份循环，DSBPLAY_LOOPING标志是整个buffer到end处然后重新从头的播放，如果你在静态的缓冲区的播放到末端后然后将play光标设置到起始位置重新播放，会导致audio glitches，因为DirectSound必须忽略所有的预处理的数据。所以，如果要循环播放，一定要在stream buffer中进行。
最后，我们来谈一下缓冲区管理。
通过IDirectSoundBuffer8::GetCaps方法我们可以获取DirectSoundBuffer对象的一些属性。应用程序可以通过IDirectSoundBuffer8::GetStatus方法还获取buffer是播放还是停止状态。
通过IDirectSoundBuffer8::GetFormat方法可以获取buffer中音频数据的格式，你也可以调用IDirectSoundBuffer8::SetFormat方法来主缓冲区的数据格式。
Sound Buffer中的一些数据在某些条件下有可能丢失，例如，如果buffer位于声卡的内存中，此时其他的应用程序获取硬件的控制权并请求资源。当具有Write_primary权限的应用程序moves to forground，此时，Directsound就会使其他的buffer内容丢失才能够让foreground的应用程序直接向主缓冲区中写数据。
当IDirectSoundBuffer8::Lock or IDirectSoundBuffer8::Play方法向一个lost buffer进行操作时，就会返回一个错误码。当造成buffer丢失的应用程序降低协作度，低于write_primary，或者moves to background，其他的应用程序可以调用IDirectSoundBuffer8::Restore来重新分配内存，如果成功，这个方法就会恢复内存中的内容以及对该内存的设置，但是，恢复的缓冲区中不包含合法的数据，因此，应用程序要重新向该buffer中填写数据。