ホーム › Media.Audio.DirectMusic › IDirectMusicSynth8

IDirectMusicSynth8

COM

IID53cab625-2711-4c9f-9de7-1b7f925f6fc8継承元IDirectMusicSynth自前メソッド開始 vtbl20

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 20 HRESULT PlayVoice(LONGLONG rt, DWORD dwVoiceId, DWORD dwChannelGroup, DWORD dwChannel, DWORD dwDLId, INT prPitch, INT vrVolume, ULONGLONG stVoiceStart, ULONGLONG stLoopStart, ULONGLONG stLoopEnd)

rt	LONGLONG	in	発音開始のタイムスタンプ(REFERENCE_TIME、100ナノ秒単位)。
dwVoiceId	DWORD	in	再生するボイスを一意に識別するID。後のStopVoiceで参照する。
dwChannelGroup	DWORD	in	ボイスを割り当てるチャンネルグループ(1起点)。
dwChannel	DWORD	in	ボイスを割り当てるチャンネル(0起点)。
dwDLId	DWORD	in	使用するダウンロード済みウェーブのダウンロードID。
prPitch	INT	in	ピッチ調整量(ピッチ周波数比、固定小数表現)。
vrVolume	INT	in	音量調整量(ボリューム比、固定小数表現)。
stVoiceStart	ULONGLONG	in	ウェーブ内の再生開始サンプル位置。
stLoopStart	ULONGLONG	in	ループ開始サンプル位置。
stLoopEnd	ULONGLONG	in	ループ終了サンプル位置。ループ不要なら開始と同値。

vtbl 21 HRESULT StopVoice(LONGLONG rt, DWORD dwVoiceId)

rt	LONGLONG	in	発音停止のタイムスタンプ(REFERENCE_TIME)。
dwVoiceId	DWORD	in	停止するボイスのID(PlayVoiceで指定した値)。

vtbl 22 HRESULT GetVoiceState(DWORD* dwVoice, DWORD cbVoice, DMUS_VOICE_STATE* dwVoiceState)

dwVoice	DWORD*	inout	状態を取得するボイスIDの配列へのポインタ。
cbVoice	DWORD	in	dwVoice配列の要素数。
dwVoiceState	DMUS_VOICE_STATE*	inout	各ボイスの再生状態を受け取るDMUS_VOICE_STATE配列へのポインタ。

vtbl 23 HRESULT Refresh(DWORD dwDownloadID, DWORD dwFlags)

dwDownloadID	DWORD	in	再評価する対象のダウンロードID。
dwFlags	DWORD	in	更新動作を制御するフラグ。通常は0。

vtbl 24 HRESULT AssignChannelToBuses(DWORD dwChannelGroup, DWORD dwChannel, DWORD* pdwBuses, DWORD cBuses)

dwChannelGroup	DWORD	in	対象チャンネルグループ(1起点)。
dwChannel	DWORD	in	対象チャンネル(0起点)。
pdwBuses	DWORD*	inout	このチャンネルの出力先となるバス番号配列へのポインタ。
cBuses	DWORD	in	pdwBuses配列の要素数。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IDirectMusicSynth8 "{53CAB625-2711-4C9F-9DE7-1B7F925F6FC8}"
#usecom global IDirectMusicSynth8 IID_IDirectMusicSynth8 "{58C2B4D0-46E7-11D1-89AC-00A0C9054129}"
#comfunc global IDirectMusicSynth8_PlayVoice             20 int64,int,int,int,int,int,int,int64,int64,int64
#comfunc global IDirectMusicSynth8_StopVoice             21 int64,int
#comfunc global IDirectMusicSynth8_GetVoiceState         22 var,int,var
#comfunc global IDirectMusicSynth8_Refresh               23 int,int
#comfunc global IDirectMusicSynth8_AssignChannelToBuses  24 int,int,var,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IDirectMusicSynth8 "{53CAB625-2711-4C9F-9DE7-1B7F925F6FC8}"
#usecom global IDirectMusicSynth8 IID_IDirectMusicSynth8 "{58C2B4D0-46E7-11D1-89AC-00A0C9054129}"
#comfunc global IDirectMusicSynth8_PlayVoice             20 int64,int,int,int,int,int,int,int64,int64,int64
#comfunc global IDirectMusicSynth8_StopVoice             21 int64,int
#comfunc global IDirectMusicSynth8_GetVoiceState         22 sptr,int,sptr
#comfunc global IDirectMusicSynth8_Refresh               23 int,int
#comfunc global IDirectMusicSynth8_AssignChannelToBuses  24 int,int,sptr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。