Platform SDK: DirectX |
IDirectMusicPerformance::AllocPMsg メソッドは、パフォーマンス メッセージを割り当てる。
HRESULT AllocPMsg( ULONG cb, DMUS_PMSG** 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::FreePMsg、IDirectMusicPerformance::SendPMsg、DirectMusic メッセージ