Microsoft DirectX 8.0 (C++) |
パフォーマンス メッセージを割り当てる。
HRESULT AllocPMsg( ULONG cb, DMUS_PMSG** ppPMSG );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
E_INVALIDARG |
E_OUTOFMEMORY |
E_POINTER |
メッセージ構造体の dwSize メンバは、cb の値に設定される。内部キャッシングのため、ほかのメンバを 0 に初期化する必要はない。
メッセージが IDirectMusicPerformance8::SendPMsg によって送信された後は、アプリケーションはメモリを確保せず、メッセージの解放も行わない。ただし、ツールは、その IDirectMusicTool8::Flush メソッドまたは IDirectMusicTool8::ProcessPMsg メソッド内でメッセージを解放できる。アプリケーションは、通知メッセージの解放も行う。
ヘッダー : dmusici.h で宣言。
IDirectMusicPerformance8::FreePMsg、IDirectMusicPerformance8::SendPMsg、DirectMusic メッセージ