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