Microsoft DirectX 8.0 (C++) |
IDirectMusic8::Activate メソッドは、このインターフェイスによって作成されたすべてのポートをアクティブまたは非アクティブにする。
HRESULT Activate( BOOL fEnable );
成功した場合は S_OK を返す。
失敗した場合は DSERR_NODRIVER を返し、サウンド ドライバがないことを示す。
アプリケーションがバックグラウンドで音楽を再生する必要がない場合、入力フォーカスを失った段階で IDirectMusic8::Activate (FALSE) を呼び出すべきである。この結果、入力フォーカスが置かれているほかのアプリケーションはこれらのポートにアクセスできる。入力フォーカスが再びこのアプリケーションに置かれた段階で、Activate (TRUE) を呼び出し、割り当てられているすべてのポートを使用可能にすべきである。
ヘッダー : dmusicc.h で宣言。