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 内容