Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.InitAudio

パフォーマンスを初期化し、オプションでデフォルトのオーディオパスをセットアップする。このメソッドは、オーディオパスを使ってパフォーマンスを演奏する前に、呼び出す必要がある。

object.InitAudio( _
  hwnd As Long, _
  lFlags As CONST_DMUS_AUDIO, _
  AudioParams As DMUS_AUDIOPARAMS, _
  [DirectSound As DirectSound8], _
  [lDefaultPathType As CONST_DMUSIC_STANDARD_AUDIO_PATH], _
  [lPChannelCount As Long] )

指定項目

object
DirectMusicPerformance8 オブジェクトを指定する。
hwnd
DirectSound の作成に使用するウィンドウ ハンドル。0 を指定すると、前面ウィンドウが使用される。「注意」を参照すること。

DirectSound8 オブジェクトを DirectSound のメソッドに渡す場合、このパラメータは無視される。その場合、アプリケーションは、DirectSound8.SetCooperativeLevel を使ってウィンドウ ハンドルを設定しなければならない。

lFlags
要求された機能を指定する CONST_DMUS_AUDIO 列挙型のフラグ。AudioParams 型の lValidData メンバの値が 0 でない場合、この値は無視されるので、要求された機能は AudioParamslFeatures メンバで指定する。
AudioParams
シンセサイザのパラメータを指定し、どのパラメータが設定されたかについての情報を受け取る DMUS_AUDIOPARAMS 型。 lValidData メンバが 0 である場合、デフォルトのパラメータが設定される。
DirectSound
ウェーブ出力のデフォルトで使用される、 DirectSound8 オブジェクト。省略可。

このパラメータが、NULL に設定された変数 DirectSound8 である場合、DirectSound オブジェクトが作成され、変数 DirectSound8 にはこのオブジェクトが設定される。

このパラメータが省略される場合、内部用の DirectSound8 オブジェクトが作成される。

「注意」を参照すること。

lDefaultPathType
デフォルトのオーディオパス タイプを指定する値。デフォルトのパス タイプが不要ならば 0 を指定するか、省略する。それ以外の場合は CONST_DMUSIC_STANDARD_AUDIO_PATH 列挙型のいずれかの定数を指定する。
lPChannelCount
lDefaultPathType が 0 以外である場合、または省略されていない場合、パスに割り当てるパフォーマンス チャンネル数を指定する値。

戻り値

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

DMUS_E_ALREADY_INITED
DMUS_E_OUTOFMEMORY

注意

このメソッドは 1 回だけ呼び出すべきである。

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

DirectSound8 オブジェクトが存在できるのは 1 つのプロセスにつき 1 つだけである。アプリケーションで DirectSound8 を個別に使用する場合は、DirectSound でそのオブジェクトを渡さなければならない。最初に、DSSCL_PRIORITY を DirectSound8.SetCooperativeLevel に渡して協調レベルを設定する必要がある。

現在の前面ウィンドウのハンドルを DirectSound に渡すには、hwnd パラメータに 0 を設定するとよい。ただし、初期化時にアプリケーション ウィンドウが前面にあると仮定するべきではない。最上位アプリケーション ウィンドウ ハンドルを渡すのが望ましい。

lFlagsAudioParams に設定されたパラメータは、デフォルトのオーディオパスと、これ以降に作成されるすべてのオーディオパスに適用される。