Platform SDK: DirectX

DirectSoundCreate

DirectSoundCreate 関数は、IDirectSound インターフェイスの作成と初期化を行う。

HRESULT WINAPI DirectSoundCreate(
  LPCGUID lpcGuid,         
  LPDIRECTSOUND * ppDS,  
  LPUNKNOWN  pUnkOuter  
);

パラメータ

lpcGuid
サウンド デバイスを識別する GUID のアドレス。このパラメータの値は DirectSoundEnumerate が返した GUID のいずれか、またはデフォルトのデバイスを指定する NULL でなければならない。
ppDS
この関数が作成した DirectSound オブジェクトへのポインタのアドレス。
pUnkOuter
全体の未定義のコントロール。この値は NULL でなければならない。

戻り値

成功すれば DS_OK、失敗すれば次のエラー値のいずれかを返す。

DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_NOAGGREGATION
DSERR_NODRIVER
DSERR_OUTOFMEMORY

注意

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

動作環境

  Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。

参照

IDirectSound::GetCapsIDirectSound::SetCooperativeLevel