Platform SDK: DirectX |
IDirectMusicPerformance::Init メソッドは、パフォーマンスを DirectMusic オブジェクトと DirectSound オブジェクトに関連付ける。
HRESULT Init( IDirectMusic** ppDirectMusic, LPDIRECTSOUND pDirectSound, HWND hWnd );
変数に NULL が含まれる場合、DirectMusic オブジェクトが作成され、インターフェイス ポインタが返される。
ppDirectMusic が NULL の場合、DirectMusic オブジェクトが作成され、パフォーマンスによって内部的に使用される。
「注意」を参照すること。
pDirectSound が NULL の場合、このパラメータは無視される。その場合、IDirectSound::SetCooperativeLevel の呼び出しにおいて、アプリケーションがウィンドウ ハンドルの設定を行わなければならない。
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DMUS_E_ALREADY_INITED |
E_OUTOFMEMORY |
E_POINTER |
このメソッドは 1 回だけ呼び出すべきであり、パフォーマンスが演奏を開始する前に呼び出さなければならない。
DirectMusic オブジェクトは、以下の方法のいずれかを使って、パフォーマンスに関連付けることができる。
パフォーマンスを解放する前に、IDirectMusicPerformance::CloseDown メソッドを使ってパフォーマンスを終了しなければならない。
hWnd パラメータに NULL を渡して、現在の前面ウィンドウ ハンドルを DirectSound に渡すことができる。ただし、アプリケーション ウィンドウが初期化中に前面にあると想定しないこと。通常、最上レベルのアプリケーション ウィンドウ ハンドルは、DirectMusic、DirectSound、および DirectDraw に渡される。「IDirectSound::SetCooperativeLevel」の「注意」を参照すること。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。