Platform SDK: DirectX

IDirectMusic::CreateMusicBuffer

IDirectMusic::CreateMusicBuffer メソッドは、ポートにシーケンス化されているミュージック メッセージを保持する DirectMusicBuffer オブジェクトを作成する。ポートの追加時にバッファ管理はパフォーマンスによって処理されるため、ほとんどのアプリケーションはこのメソッドを呼び出す必要がない。

HRESULT CreateMusicBuffer(
  LPDMUS_BUFFERDESC pBufferDesc, 
  LPDIRECTMUSICBUFFER *ppBuffer, 
  LPUNKNOWN pUnkOuter 
);

パラメータ

pBufferDesc
作成されるミュージック バッファの記述を保持する DMUS_BUFFERDESC 構造体のアドレス。ポインタを渡す前に、アプリケーションはこの構造体の dwSize メンバを初期化しなければならない。「注意」を参照すること。
ppBuffer
IDirectMusicBuffer インターフェイスポインタを受け取る変数のアドレス。
pUnkOuter
COM 集合体の場合は、制御オブジェクトの IUnknown インターフェイスのアドレス。集合体は現在サポートされていないため、この値は NULL に設定しなければならない。

戻り値

成功すれば S_OK を返す。

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

E_INVALIDARG
E_NOAGGREGATION
E_NOINTERFACE
E_OUTOFMEMORY
E_POINTER

動作環境

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