Microsoft DirectX 8.0 (C++)

DirectSoundCreate8

IDirectSound8 インターフェイスをサポートするオブジェクトを作成および初期化する。

HRESULT WINAPI DirectSoundCreate8(
  LPCGUID lpcGuidDevice,         
  LPDIRECTSOUND8 * ppDS8,  
  LPUNKNOWN  pUnkOuter  
);

パラメータ

lpcGuidDevice
サウンド デバイスを識別する GUID のアドレス。このパラメータの値は、DirectSoundEnumerate が返した GUID のいずれか、またはデフォルトのデバイスを指定する NULL、または次のいずれかの値でなければならない。
DSDEVID_DefaultPlayback
システムワイドなデフォルトのオーディオ再生デバイス。NULL に等しい。
DSDEVID_DefaultVoicePlayback
デフォルトの音声再生デバイス。
ppDS8
IDirectSound8 インターフェイス ポインタを受け取る変数のアドレス。
pUnkOuter
COM 集成体に対する制御オブジェクトの IUnknown インターフェイスのアドレス。集成体はサポートされていないため、NULL に設定しなければならない。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_NOAGGREGATION
DSERR_NODRIVER
DSERR_OUTOFMEMORY

注意

アプリケーションは DirectSound オブジェクトを作成した直後に、IDirectSound8::SetCooperativeLevel メソッドを呼び出さなければならない。

動作環境

  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。

参照

IDirectSound8::GetCapsIDirectSound8::SetCooperativeLevel