Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::FreePMsg

メッセージを解放する。

HRESULT FreePMsg(
  DMUS_PMSG* pPMSG
); 

パラメータ

pPMSG
解放するメッセージを含む変数のアドレス。このメッセージは、IDirectMusicPerformance8::AllocPMsg メソッドを使って割り当てておく必要がある。

戻り値

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

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

DMUS_E_CANNOT_FREE
E_POINTER

注意

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

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

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

動作環境

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

参照

IDirectMusicPerformance8::AllocPMsgDirectMusic メッセージ