DirectSoundCreate8

DirectSoundCreate8 関数は、IDirectSound8 インターフェイスをサポートするオブジェクトを作成し、初期化します。

HRESULT 
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

解説 

アプリケーションは、デバイス オブジェクトを作成したすぐ後に IDirectSound8::SetCooperativeLevel メソッドを呼び出す必要があります。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound.lib 内容

関連項目

IDirectSound8::GetCaps | IDirectSound8::SetCooperativeLevel | デバイス オブジェクトの作成