Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::AllocPMsg

パフォーマンス メッセージを割り当てる。

HRESULT AllocPMsg(
  ULONG cb,
  DMUS_PMSG** ppPMSG
);

パラメータ

cb
メッセージ構造体のサイズ。この構造体は、DMUS_PMSG の派生タイプである。
ppPMSG
割り当てられたメッセージ構造体へのポインタを受け取る変数のアドレス。

戻り値

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

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

E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

メッセージ構造体の dwSize メンバは、cb の値に設定される。内部キャッシングのため、ほかのメンバを 0 に初期化する必要はない。

メッセージが IDirectMusicPerformance8::SendPMsg によって送信された後は、アプリケーションはメモリを確保せず、メッセージの解放も行わない。ただし、ツールは、その IDirectMusicTool8::Flush メソッドまたは IDirectMusicTool8::ProcessPMsg メソッド内でメッセージを解放できる。アプリケーションは、通知メッセージの解放も行う。

動作環境

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

参照

IDirectMusicPerformance8::FreePMsgIDirectMusicPerformance8::SendPMsgDirectMusic メッセージ