ホーム › Media.Audio.DirectMusic › IDirectMusicSynth8

IDirectMusicSynth8

COM

📘 Microsoft Learn (日本語) · English

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

公式ドキュメント

IDirectMusicSynth8 はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

メソッド 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)

PlayVoice はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

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	PREL はここでは定義されていません。
vrVolume	INT	in	VREL はここでは定義されていません。
stVoiceStart	ULONGLONG	in	ウェーブ内の再生開始サンプル位置。
stLoopStart	ULONGLONG	in	ループ開始サンプル位置。
stLoopEnd	ULONGLONG	in	ループ終了サンプル位置。ループ不要なら開始と同値。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 21 HRESULT StopVoice(LONGLONG rt, DWORD dwVoiceId)

StopVoice はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

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

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

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

GetVoiceState はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

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

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 23 HRESULT Refresh(DWORD dwDownloadID, DWORD dwFlags)

Refresh はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

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

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

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

AssignChannelToBuses はサポートされていません。将来変更されるか、利用できなくなる可能性があります。

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

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

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(変数))。