Platform SDK: DirectX

IDirectMusicBuffer::GetNextEvent

IDirectMusicBuffer::GetNextEvent メソッドは、バッファ内の以下のメッセージに関する情報を返し、読み込みポインタを先に進める。

HRESULT GetNextEvent(
  LPREFERENCE_TIME prt, 
  LPDWORD pdwChannelGroup, 
  LPDWORD pdwLength, 
  LPBYTE* ppData
);

パラメータ

prt
メッセージのタイムを受け取る変数のアドレス。
pdwChannelGroup
メッセージのチャンネル グループを受け取る変数のアドレス。
pdwLength
メッセージの長さ (バイト単位) を受け取る変数のアドレス。
ppData
メッセージデータへのポインタを受け取る変数のアドレス。

戻り値

成功すれば S_OK を返す。ただし、バッファ内にメッセージが存在しなかった場合は S_FALSE を返す。

失敗すれば E_POINTER を返す。

注意

項目が必要ない場合、該当するポインタとして NULL を指定してもよい。

ppData に返されたポインタは、バッファオブジェクトの寿命の間に限って有効である。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicBuffer::ResetReadPtr