Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::Clone

セグメントとその中のトラックのすべてまたはパートをコピーする。

HRESULT Clone(
  MUSIC_TIME mtStart, 
  MUSIC_TIME mtEnd, 
  IDirectMusicSegment** ppSegment
);

パラメータ

mtStart
コピー開始パート。0 未満の場合や、セグメントの長さを超える場合は、0 が使われる。
mtEnd
コピー終了パート。この値がセグメントの最後を超える場合は、セグメントの最後までコピーされる。0、または mtStart 未満の場合も、最後までコピーされる。
ppSegment
作成されたセグメントの IDirectMusicSegment インターフェイスへのポインタを受け取る変数のアドレス。IDirectMusicSegment8 を取得するには、QueryInterface を使用する。アプリケーションには、セグメントの終了時に Release を呼び出す責任がある。

戻り値

成功した場合は S_OK を返す。一部のトラックのコピーに失敗した場合は S_FALSE を返す。

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

E_OUTOFMEMORY
E_POINTER

注意

開始ポイント、ループ ポイント、反復回数、ツールグラフ、デフォルトのオーディオパスなど、オリジナルのセグメントのプロパティがクローンにコピーされる。

スタイルベースのセグメントは、mtStart が 0 より大きい場合、小節境界上になければならない。

動作環境

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