Platform SDK: DirectX

IDirectMusicPerformance::AllocPMsg

IDirectMusicPerformance::AllocPMsg メソッドは、パフォーマンス メッセージを割り当てる。

HRESULT AllocPMsg(
  ULONG cb,
  DMUS_PMSG** ppPMSG
);

パラメータ

cb
メッセージ構造体のサイズ。ほかのさまざまなタイプについては、「メッセージ」を参照すること。
ppPMSG
割り当てられたメッセージ構造体へのポインタを受け取る変数のアドレス。

戻り値

成功すれば S_OK を返す。

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

E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

返されたメモリは特定の状態に初期化されていない。ただし、DMUS_PMSG 構造体の pTool メンバと dwSize メンバは例外で、前者は 0 に初期化され、後者は cb の値に設定される。

メッセージが IDirectMusicPerformance::SendPMsg によっていったん送信されると、アプリケーションはメモリを確保せず、メッセージの解放も行わない。ただし、ツールは、その IDirectMusicTool::Flush メソッドまたは IDirectMusicTool::ProcessPMsg メソッド内でメッセージを解放できる。アプリケーションは、通知メッセージの解放も行う。

動作環境

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

参照

IDirectMusicPerformance::FreePMsgIDirectMusicPerformance::SendPMsgDirectMusic メッセージ