Platform SDK: DirectX

IDirectMusicSegment::SetLength

IDirectMusicSegment::SetLength メソッドは、セグメントの長さをミュージック タイム単位で設定する。通常、ローダーがファイルからセグメントの長さを取り出して、その長さをセグメント オブジェクトに渡すときに、ローダーがこのメソッドを呼び出す。

HRESULT SetLength(
  MUSIC_TIME mtLength
);

パラメータ

mtLength
希望の長さ。0 より大きい値でなければならない。

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

E_INVALIDARG
DMUS_E_OUT_OF_RANGE

注意

プライマリ セグメントの長さを設定しなかった場合、DMUS_SEGF_QUEUE フラグを指定した他のプライマリ セグメントをキューに挿入する際に問題が発生することがある。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicSegment::GetLength