Microsoft DirectX 8.0 (C++) |
メッセージを解放する。
HRESULT FreePMsg( DMUS_PMSG* pPMSG );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_CANNOT_FREE |
E_POINTER |
ほとんどのメッセージは、処理されると、パフォーマンスによって自動的に解放される。また、IDirectMusicPerformance8::SendPMsg を使って送信されたメッセージに対して、IDirectMusicPerformance8::FreePMsg を呼び出してはならない。ただし、IDirectMusicPerformance8::FreePMsg は、IDirectMusicTool8::ProcessPMsg または IDirectMusicTool8::Flush の中で使うと、不要なメッセージを解放することができる。通知メッセージを解放する際にも、IDirectMusicPerformance::FreePMsg を使用しなければならない。
このメソッドは、以下の場合に DMUS_E_CANNOT_FREE を返す。
pTool、pGraph、punkUser のいずれかのメンバ (「DMUS_PMSG」を参照) 内に値が存在する場合、参照されている各オブジェクトは解放される。
ヘッダー : dmusici.h で宣言。