Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::IsPlaying

特定のセグメントまたはセグメント状態がスピーカから聞こえているかどうかを判別する。

HRESULT IsPlaying(
  IDirectMusicSegment* pSegment,
  IDirectMusicSegmentState* pSegState
);

パラメータ

pSegment
チェックされるセグメント。NULL の場合、pSegState だけをチェックする。
pSegState
チェックされるセグメント状態。NULL の場合、pSegment だけをチェックする。

戻り値

このメソッドが成功し、要求したセグメントとセグメント状態のどちらかが演奏されている場合は S_OK を返す。どちらも演奏されていない場合、またはどちらか 1 つだけを要求し、それが演奏されていない場合は、S_FALSE を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_POINTER
DMUS_E_NO_MASTER_CLOCK

注意

セグメントまたはセグメント状態が実際にスピーカで演奏中である場合にのみ、S_OK が返される。IDirectMusicPerformance8::PlaySegmentIDirectMusicPerformance8::PlaySegmentEx がセグメントに対して呼び出された直後でも、遅延時間があるので、S_FALSE が返される可能性がある。同様の理由で、すべてのメッセージが既に発信されている場合でも、セグメントが聞こえている間は、S_OK が返される。

動作環境

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