Platform SDK: DirectX

IDirectMusic::Activate

IDirectMusic::Activate メソッドは、このインターフェイスによって作成されたすべての出力ポートのアクティブ化または非アクティブ化を行う。

HRESULT Activate(
  BOOL fEnable
);

パラメータ

fEnable
DirectMusic のこのインスタンスで作成されたすべてのポートをアクティブ化 (TRUE) または非アクティブ化 (FALSE) する。

戻り値

成功すれば S_OK を返す。

失敗すれば DSERR_NODRIVER を返し、サウンド ドライバがないことを示す。

注意

アプリケーションがバックグラウンドで音楽を再生する必要がない場合、入力フォーカスを失った段階で IDirectMusic::Activate(FALSE) を呼び出すべきである。この結果、入力フォーカスが置かれている他のアプリケーションはこれらのポートにアクセスできる。入力フォーカスが再びこのアプリケーションに置かれた段階で、Activate(TRUE) を呼び出し、割り当てられているすべてのポートを使用可能にすべきである。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPort::Activate