Win32 API 日本語リファレンス
ホーム › Media.Audio.XAudio2 › IXAudio2

IXAudio2

COM
📘 Microsoft Learn (日本語) · English
IID2b02e3cf-2e0b-4ec3-be45-1b2a3fe7210d継承元IUnknown自前メソッド開始 vtbl3

メソッド 10

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

vtbl 3 HRESULT RegisterForCallbacks(IXAudio2EngineCallback* pCallback)
pCallbackIXAudio2EngineCallback*inエンジンコールバックを受け取るIXAudio2EngineCallback実装へのポインター。
vtbl 4 void UnregisterForCallbacks(IXAudio2EngineCallback* pCallback)
pCallbackIXAudio2EngineCallback*in登録解除する対象のIXAudio2EngineCallback実装へのポインター。
vtbl 5 HRESULT CreateSourceVoice(IXAudio2SourceVoice** ppSourceVoice, WAVEFORMATEX* pSourceFormat, DWORD Flags, FLOAT MaxFrequencyRatio, IXAudio2VoiceCallback* pCallback, XAUDIO2_VOICE_SENDS* pSendList, XAUDIO2_EFFECT_CHAIN* pEffectChain)
ppSourceVoiceIXAudio2SourceVoice**out生成されたソースボイスを受け取るIXAudio2SourceVoiceへの出力ポインター。
pSourceFormatWAVEFORMATEX*inソースボイスが受け取る入力オーディオ形式を表すWAVEFORMATEXへのポインター。
FlagsDWORDinボイス生成時の動作を制御するフラグ。XAUDIO2_VOICE_NOPITCH等の組み合わせ。通常は0。
MaxFrequencyRatioFLOATin周波数比の最大値を指定するFLOAT値。ピッチ変更の上限を定める。
pCallbackIXAudio2VoiceCallback*inoptionalボイス処理イベントを受け取るIXAudio2VoiceCallback実装へのポインター。NULL可。
pSendListXAUDIO2_VOICE_SENDS*inoptional出力先ボイスの一覧を記述するXAUDIO2_VOICE_SENDSへのポインター。NULLでマスタリングボイスへ送出。
pEffectChainXAUDIO2_EFFECT_CHAIN*inoptionalボイスに適用するエフェクトチェーンを記述するXAUDIO2_EFFECT_CHAINへのポインター。NULL可。
vtbl 6 HRESULT CreateSubmixVoice(IXAudio2SubmixVoice** ppSubmixVoice, DWORD InputChannels, DWORD InputSampleRate, DWORD Flags, DWORD ProcessingStage, XAUDIO2_VOICE_SENDS* pSendList, XAUDIO2_EFFECT_CHAIN* pEffectChain)
ppSubmixVoiceIXAudio2SubmixVoice**out生成されたサブミックスボイスを受け取るIXAudio2SubmixVoiceへの出力ポインター。
InputChannelsDWORDinサブミックスボイスの入力チャンネル数を指定するDWORD値。
InputSampleRateDWORDinサブミックスボイスの入力サンプリングレートをHz単位のDWORDで指定する。
FlagsDWORDinボイス生成時の動作を制御するフラグ。通常は0。
ProcessingStageDWORDinサブミックスの処理段階を示すDWORD値。値が小さいほど先に処理される。
pSendListXAUDIO2_VOICE_SENDS*inoptional出力先ボイスの一覧を記述するXAUDIO2_VOICE_SENDSへのポインター。NULL可。
pEffectChainXAUDIO2_EFFECT_CHAIN*inoptional適用するエフェクトチェーンを記述するXAUDIO2_EFFECT_CHAINへのポインター。NULL可。
vtbl 7 HRESULT CreateMasteringVoice(IXAudio2MasteringVoice** ppMasteringVoice, DWORD InputChannels, DWORD InputSampleRate, DWORD Flags, LPWSTR szDeviceId, XAUDIO2_EFFECT_CHAIN* pEffectChain, AUDIO_STREAM_CATEGORY StreamCategory)
ppMasteringVoiceIXAudio2MasteringVoice**out生成されたマスタリングボイスを受け取るIXAudio2MasteringVoiceへの出力ポインター。
InputChannelsDWORDin入力チャンネル数を指定するDWORD値。XAUDIO2_DEFAULT_CHANNELSで既定値を使用する。
InputSampleRateDWORDin入力サンプリングレートをHz単位で指定する。XAUDIO2_DEFAULT_SAMPLERATEで既定値を使用する。
FlagsDWORDinボイス生成時の動作を制御するフラグ。予約済みのため通常は0。
szDeviceIdLPWSTRinoptional出力先オーディオデバイスを識別する文字列。NULLで既定デバイスを使用する。
pEffectChainXAUDIO2_EFFECT_CHAIN*inoptional適用するエフェクトチェーンを記述するXAUDIO2_EFFECT_CHAINへのポインター。NULL可。
StreamCategoryAUDIO_STREAM_CATEGORYinオーディオストリームの分類を指定するAUDIO_STREAM_CATEGORY列挙値。
vtbl 8 HRESULT StartEngine()
vtbl 9 void StopEngine()
vtbl 10 HRESULT CommitChanges(DWORD OperationSet)
OperationSetDWORDin一括適用する操作セットを識別するDWORD値。XAUDIO2_COMMIT_ALLで全操作を確定する。
vtbl 11 void GetPerformanceData(XAUDIO2_PERFORMANCE_DATA* pPerfData)
pPerfDataXAUDIO2_PERFORMANCE_DATA*outエンジンの性能統計を受け取るXAUDIO2_PERFORMANCE_DATAへのポインター。
vtbl 12 void SetDebugConfiguration(XAUDIO2_DEBUG_CONFIGURATION* pDebugConfiguration, void* pReserved)
pDebugConfigurationXAUDIO2_DEBUG_CONFIGURATION*inoptionalデバッグログ出力の設定を記述するXAUDIO2_DEBUG_CONFIGURATIONへのポインター。
pReservedvoid*optional予約済みパラメーター。NULLを指定する。

HSP用 COM定義

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

出力引数: 
#define global IID_IXAudio2 "{2B02E3CF-2E0B-4EC3-BE45-1B2A3FE7210D}"
#usecom global IXAudio2 IID_IXAudio2 "{}"
#comfunc global IXAudio2_RegisterForCallbacks    3 sptr
#comfunc global IXAudio2_UnregisterForCallbacks  4 sptr
#comfunc global IXAudio2_CreateSourceVoice       5 sptr,var,int,float,sptr,var,var
#comfunc global IXAudio2_CreateSubmixVoice       6 sptr,int,int,int,int,var,var
#comfunc global IXAudio2_CreateMasteringVoice    7 sptr,int,int,int,wstr,var,int
#comfunc global IXAudio2_StartEngine             8
#comfunc global IXAudio2_StopEngine              9
#comfunc global IXAudio2_CommitChanges           10 int
#comfunc global IXAudio2_GetPerformanceData      11 var
#comfunc global IXAudio2_SetDebugConfiguration   12 var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。