Platform SDK: DirectX

DirectMusicPerformance.Init

DirectMusicPerformance.Init メソッドは、パフォーマンスを初期化し、それを DirectSound オブジェクトに関連付ける。パフォーマンスに対してその他のメソッドを呼び出す前に、このメソッドは一度しか呼び出すことができない。

object.Init(DirectSound As DirectSound, hwnd As Long)

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
DirectSound
既存の DirectSound オブジェクト。DirectMusic によってオブジェクトが作成されるようにしたい場合は NULL を指定する。
hwnd
DirectSound の作成に使用するウィンドウ ハンドル。このパラメータは 0 でもよい。その場合、前面ウィンドウが使用される。「注意」を参照すること。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_ALREADY_INITED
DMUS_E_OUTOFMEMORY

注意

DirectSound オブジェクトが存在できるのは 1 つのプロセスにつき 1 つだけである。アプリケーションがウェーブの演奏に DirectSound オブジェクトを使用する場合、オブジェクトをこのメソッドに渡さなければならない。

DirectSound が NULL の場合にだけ hwnd パラメータが重要になる。DirectSound オブジェクトがアプリケーションによって個別に作成され、このメソッドに渡された場合、DirectSound.SetCooperativeLevel の呼び出しで、アプリケーションがウィンドウ ハンドルを設定しなければならない。

メソッドの呼び出し時にアプリケーション ウィンドウが前面にない場合があるため、hwnd に 0 を渡さないこと。通常、最上位のアプリケーション ウィンドウ ハンドルは、DirectMusicPerformance.InitDirectSound.SetCooperativeLevel、および DirectDraw7.SetCooperativeLevel に渡さなければならない。

パフォーマンスを解放する前に、DirectMusicPerformance.CloseDown メソッドを使ってパフォーマンスを終了しなければならない。