Microsoft DirectX 8.0 (C++)

IDirectMusicAudioPath8::Activate

オーディオパスをアクティブまたは非アクティブにする。

HRESULT Activate(
  BOOL fActivate
);

パラメータ

fActivate
パスをアクティブ (TRUE) にするか、または非アクティブ (FALSE) にするかを指定するブール値。

戻り値

成功した場合は S_OK を返す。オーディオパスが既に要求された状態になっている場合は S_FALSE を返す。

注意

このメソッドの動作は、IDirectMusicPort8::Activate の動作とは異なる。ポートを非アクティブにすると、ポートではサウンドが生成されなくなるが、パフォーマンスによってセグメントの再生を継続できる。オーディオパスを非アクティブにすると、すべての再生が停止して、セグメントを再生できなくなる。

動作環境

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