Microsoft DirectX 8.0 (C++)

IDirectSound8::Initialize

CoCreateInstance 関数を使って作成された DirectSound オブジェクトを初期化する。

HRESULT Initialize(
  LPCGUID pcGuidDevice 
);

パラメータ

pcGuidDevice
DirectSound オブジェクトに割り当てられるサウンド ドライバを指定する GUID (グローバル ユニーク識別子) アドレス。プライマリ サウンド ドライバを選択するには、NULL を渡す。

戻り値

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

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

DSERR_ALREADYINITIALIZED
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_NODRIVER

注意

このメソッドは COM プロトコルに準拠して提供されている。DirectSoundCreate8 関数を使って DirectSound オブジェクトを作成した場合、このメソッドは DSERR_ALREADYINITIALIZED を返す。CoCreateInstance を使って DirectSound オブジェクトを作成するときに、IDirectSound8::Initialize を呼び出さないと、その後に呼び出したすべてのメソッドは DSERR_UNINITIALIZED を返す。

動作環境

  ヘッダー : dsound.h で宣言。