Platform SDK: DirectX |
DirectMusicPerformance.Init メソッドは、パフォーマンスを初期化し、それを DirectSound オブジェクトに関連付ける。パフォーマンスに対してその他のメソッドを呼び出す前に、このメソッドは一度しか呼び出すことができない。
object.Init(DirectSound As DirectSound, hwnd As Long)
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DMUS_E_ALREADY_INITED |
DMUS_E_OUTOFMEMORY |
DirectSound オブジェクトが存在できるのは 1 つのプロセスにつき 1 つだけである。アプリケーションがウェーブの演奏に DirectSound オブジェクトを使用する場合、オブジェクトをこのメソッドに渡さなければならない。
DirectSound が NULL の場合にだけ hwnd パラメータが重要になる。DirectSound オブジェクトがアプリケーションによって個別に作成され、このメソッドに渡された場合、DirectSound.SetCooperativeLevel の呼び出しで、アプリケーションがウィンドウ ハンドルを設定しなければならない。
メソッドの呼び出し時にアプリケーション ウィンドウが前面にない場合があるため、hwnd に 0 を渡さないこと。通常、最上位のアプリケーション ウィンドウ ハンドルは、DirectMusicPerformance.Init、DirectSound.SetCooperativeLevel、および DirectDraw7.SetCooperativeLevel に渡さなければならない。
パフォーマンスを解放する前に、DirectMusicPerformance.CloseDown メソッドを使ってパフォーマンスを終了しなければならない。