Platform SDK: DirectX

IDirectMusicPerformance::FreePMsg

IDirectMusicPerformance::FreePMsg メソッドは、メッセージを解放する。

HRESULT FreePMsg(
  DMUS_PMSG* pPMSG
); 

パラメータ

pPMSG
解放するメッセージを含む変数のアドレス。このメッセージは、IDirectMusicPerformance::AllocPMsg メソッドで割り当てられたものでなければならない。

戻り値

成功すれば S_OK を返す。

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

DMUS_E_CANNOT_FREE
E_POINTER

注意

ほとんどのメッセージは、処理されると、パフォーマンスによって自動的に解放される。また、IDirectMusicPerformance::SendPMsg を使って送信されたメッセージに対して、IDirectMusicPerformance::FreePMsg を呼び出してはならない。ただし、IDirectMusicPerformance::FreePMsgIDirectMusicTool::ProcessPMsg または IDirectMusicTool::Flush 内で使って、不要なメッセージを解放できる。通知メッセージを解放する際にも、IDirectMusicPerformance::FreePMsg を使用しなければならない。

このメソッドは、以下の場合に DMUS_E_CANNOT_FREE を返す。

pToolpGraphpunkUser いずれかのメンバ (DMUS_PMSG を参照) 内に値が存在する場合、参照されている各オブジェクトは解放される。

動作環境

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

参照

IDirectMusicPerformance::AllocPMsgDirectMusic メッセージ