Platform SDK: DirectX

IDirectMusicPortDownload::AllocateBuffer

IDirectMusicPortDownload::AllocateBuffer メソッドは、DLS データをポートへダウンロードするためのメモリ チャンクを割り当て、このバッファへのアクセスを可能にする IDirectMusicDownload インターフェイス ポインタを返す。

HRESULT AllocateBuffer(
  DWORD dwSize,
  IDirectMusicDownload** ppIDMDownload
);

パラメータ

dwSize
要求するバッファのサイズ。
ppIDMDownload
IDirectMusicDownload インターフェイス ポインタを受け取る変数のアドレス。

戻り値

成功すれば S_OK を返す。

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

E_POINTER
E_INVALIDARG
E_OUTOFMEMORY

注意

いったんバッファを割り当てたら、そのサイズは変更できない。

IDirectMusicDownload インターフェイスを解放すると、バッファも解放される。

動作環境

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

参照

IDirectMusicPortDownload::GetBuffer下位レベル DLS