プライマリバッファへの書き込み

[アーティクル]
04/22/2010

セカンダリバッファがサポートしていない特別なミキシングや他のエフェクトを必要とするアプリケーションのために、DirectSound ではプライマリバッファへの直接アクセスをが許されている。

プライマリバッファへの書き込みアクセスを取得すると、DirectSound の他の機能は利用できなくなる。セカンダリバッファのミキシングも行われないので、ハードウェアアクセラレーションミキシングも利用できなくなる。

アプリケーションは、通常、プライマリバッファへの直接アクセスではなく、セカンダリバッファを使う必要がある。セカンダリバッファへの書き込みは簡単に行うことができる。バッファサイズが大きいため、次のデータブロックの書き込みまでの時間が長くなり、オーディオの音が途切れる危険が最小限に抑えられる。アプリケーションが必要とするオーディオが、ミキシングを必要としない 1 つのオーディオストリームのような単純なものであっても、セカンダリバッファを使ってオーディオデータを再生することにより、より高い性能が実現できる。

注プライマリバッファへの直接の書き込みは、Windows Driver Model (WDM) では利点がない。WDM では、プライマリバッファは、事実上、カーネルミキサによってミキシングされるセカンダリバッファである。WDM の詳細については、「DirectSound ドライバモデル」を参照すること。

プライマリバッファのサイズは指定できず、バッファを作成した後に返されるサイズを受け入れなければならない。通常、プライマリバッファは極めて小さいので、アプリケーションがこの種のバッファに直接書き込む場合は、短い間隔でデータブロックを書き込み、以前のデータがもう一度再生されることを防がなければならない。

プライマリバッファがハードウェア上に存在していない限り、そのバッファの書き込みアクセスは取得できない。これに該当するかどうかを確認するには、IDirectSoundBuffer8::GetCaps メソッドを呼び出して、DSBCAPS 構造体の dwFlags メンバで DSBCAPS_LOCHARDWARE フラグの有無をチェックする。ソフトウェアでエミュレートされたプライマリバッファをロックしようとすると、呼び出しは失敗する。

アクセス可能なプライマリバッファを作成するには、DSBUFFERDESC 構造体に DSBCAPS_PRIMARYBUFFER フラグを設定して IDirectSound8::CreateSoundBuffer メソッドに渡す。バッファに書き込む場合、協調レベルは DSSCL_WRITEPRIMARY でなければならない。

プライマリサウンドバッファは、ループして再生しなければならない。そのためには、DSBPLAY_LOOPING フラグを必ず設定する。

次の例は、プライマリバッファへの書き込みアクセスを取得する方法を示している。プライマリバッファは IDirectSoundBuffer インターフェイスだけをサポートし、IDirectSoundBuffer8 をサポートしていないことに注意すること。

BOOL AppCreateWritePrimaryBuffer( 
  LPDIRECTSOUND8 lpDirectSound, 
  LPDIRECTSOUNDBUFFER *lplpDsb, 
  LPDWORD lpdwBufferSize, 
  HWND hwnd) 
{ 
  DSBUFFERDESC dsbdesc; 
  DSBCAPS dsbcaps; 
  HRESULT hr; 
  WAVEFORMATEX wf;
 
  // ウェーブ フォーマットの構造体を設定する。
  memset(&wf, 0, sizeof(WAVEFORMATEX)); 
  wf.wFormatTag = WAVE_FORMAT_PCM; 
  wf.nChannels = 2; 
  wf.nSamplesPerSec = 22050; 
  wf.nBlockAlign = 4; 
  wf.nAvgBytesPerSec = 
      wf.nSamplesPerSec * wf.nBlockAlign; 
  wf.wBitsPerSample = 16; 
 
  // DSBUFFERDESC 構造体を設定する。
  memset(&dsbdesc, 0, sizeof(DSBUFFERDESC));
  dsbdesc.dwSize = sizeof(DSBUFFERDESC); 
  dsbdesc.dwFlags = DSBCAPS_PRIMARYBUFFER; 
  // バッファ サイズは、サウンド ハードウェアによって決定される。
  dsbdesc.dwBufferBytes = 0; 
  dsbdesc.lpwfxFormat = NULL; // プライマリ バッファの場合は NULL でなければならない。
 
  // 書き込み優先協調レベルを取得する。
  hr = lpDirectSound->SetCooperativeLevel(hwnd, DSSCL_WRITEPRIMARY); 
  if SUCCEEDED(hr) 
  { 
    // バッファの作成を試みる。
    hr = lpDirectSound->CreateSoundBuffer(&dsbdesc, 
      lplpDsb, NULL); 
    if SUCCEEDED(hr) 
    { 
      // プライマリ バッファを目的のフォーマットに設定する。
      hr = (*lplpDsb)->SetFormat(&wf); 
      if SUCCEEDED(hr) 
      { 
        // バッファ サイズを知る必要がある場合は、GetCaps を呼び出す。
        dsbcaps.dwSize = sizeof(DSBCAPS); 
        (*lplpDsb)->GetCaps(&dsbcaps); 
        *lpdwBufferSize = dsbcaps.dwBufferBytes; 
        return TRUE; 
      } 
    } 
  } 
  // 失敗した。
  *lplpDsb = NULL; 
  *lpdwBufferSize = 0; 
  return FALSE; 
}

次の例は、アプリケーションがカスタムミキサを実装する方法を示している。サウンドデバイスがデータブロックの再生を繰り返すことのない十分に短い一定間隔で、AppMixIntoPrimaryBuffer サンプル関数を呼び出さなければならない。CustomMixer 関数はアプリケーションで定義された関数であり、アプリケーションで定義された APPSTREAMINFO 構造体の指定に従って複数のストリームをミキシングし、指定されたポインタに結果を書き込む。

BOOL AppMixIntoPrimaryBuffer( 
    APPSTREAMINFO* lpAppStreamInfo, 
    LPDIRECTSOUNDBUFFER lpDsbPrimary, 
    DWORD dwDataBytes, 
    DWORD dwOldPos, 
    LPDWORD lpdwNewPos) 
{ 
  LPVOID lpvPtr1; 
  DWORD dwBytes1; 
  LPVOID lpvPtr2; 
  DWORD dwBytes2; 
  HRESULT hr; 
  // 書き込みポインタを取得する。
  hr = lpDsbPrimary->Lock(dwOldPos, dwDataBytes, 
          &lpvPtr1, &dwBytes1, 
          &lpvPtr2, &dwBytes2, 0); 
 
  // DSERR_BUFFERLOST が返った場合は、復元してロックをリトライする。
 
  if (DSERR_BUFFERLOST == hr) 
  { 
    lpDsbPrimary->Restore(); 
    hr = lpDsbPrimary->Lock(dwOldPos, dwDataBytes,
            &lpvPtr1, &dwBytes1, 
            &lpvPtr2, &dwBytes2, 0); 
  } 
  if SUCCEEDED(hr) 
  { 
    // データをミキシングして、返されたポインタの位置に格納する。
    CustomMixer(lpAppStreamInfo, lpvPtr1, dwBytes1); 
    *lpdwNewPos = dwOldPos + dwBytes1; 
    if (NULL != lpvPtr2) 
    { 
      CustomMixer(lpAppStreamInfo, lpvPtr2, dwBytes2); 
      *lpdwNewPos = dwBytes2; // ラップ アラウンドしたため
    } 
    // データを解放して DirectSound に戻す。
    hr = lpDsbPrimary->Unlock(lpvPtr1, dwBytes1, 
            lpvPtr2, dwBytes2); 
    if SUCCEEDED(hr) 
    { 
      return TRUE; 
    } 
  } 
  // ロックまたはアンロックが失敗した。
  return FALSE; 
}

プライマリ バッファへの書き込み

その他のリソース

プライマリバッファへの書き込み