Microsoft DirectX 8.0 (C++)

IDirectMusic8::Activate

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

HRESULT Activate(
  BOOL fEnable
);

パラメータ

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

戻り値

成功した場合は S_OK を返す。

失敗した場合は DSERR_NODRIVER を返し、サウンド ドライバがないことを示す。

注意

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

動作環境

  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPort8::Activate