Microsoft DirectX 8.0 (C++)

IDirectMusicPatternTrack8::CreateSegment

パターン トラックを保持するセグメントを作成する。

HRESULT CreateSegment(
  IDirectMusicStyle* pStyle,
  IDirectMusicSegment** ppSegment
);

パラメータ

pStyle
セグメントを作成する際に使用するスタイル。
ppSegment
作成されたセグメントの IDirectMusicSegment インターフェイス ポインタを受け取る変数のアドレス。IDirectMusicSegment8 を取得するには、QueryInterface を使用する。

戻り値

成功した場合は S_OK を返す。

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

DMUS_E_NOT_INIT
E_OUTOFMEMORY

注意

パターン トラックは通常、ファイルやリソースからロードされたセグメント オブジェクトから取得される。この場合、アプリケーションは既に IDirectMusicSegment インターフェイスを持っている。このメソッドは、パターン トラック オブジェクトが CoCreateInstance で作成された場合に、セグメントを作成するために使用する。

動作環境

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