IDirectSound8::Initialize

  • [アーティクル]

Initialize メソッドは CoCreateInstance 関数を使って作成されたデバイス オブジェクトを初期化します。

HRESULT 
Initialize(
  LPCGUID pcGuidDevice
);

パラメータ

  • pcGuidDevice
    デバイス オブジェクトのバインド先となるサウンド ドライバーを指定する GUID (グローバル一意識別子) のアドレスです。プライマリ サウンド ドライバーを選択するには、NULL を渡します。

戻り値

成功した場合は、DS_OK を返します。失敗した場合は、以下の表に示すエラー値のいずれかが戻り値となります。

リターン コード
DSERR_ALREADYINITIALIZED
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_NODRIVER

解説　

このメソッドはコンポーネント オブジェクト モデル (COM) プロトコルに準拠するために提供されています。DirectSoundCreate8 関数を使ってデバイス オブジェクトを作成した場合、このメソッドは DSERR_ALREADYINITIALIZED を返します。CoCreateInstance を使ってデバイス オブジェクトを作成するときに IDirectSound8::Initialize を呼び出さないと、その後で呼び出されるメソッドはすべて DSERR_UNINITIALIZED を返します。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容

関連項目

IDirectSound8