ISpatialAudioObjectRenderStreamForHrtf
COM公式ドキュメント
Hrtf 空間オーディオ オブジェクト レンダー ストリームを制御するためのメソッドを提供します。ストリームの開始、停止、リセットなどが含まれます。
解説(Remarks)
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
オーディオ レンダリング用の ISpatialAudioObjectForHrtf をアクティブ化します。
| type | AudioObjectType | in | アクティブ化するオーディオ オブジェクトの種類。動的オーディオ オブジェクトの場合、この値は AudioObjectType_Dynamic でなければなりません。静的オーディオ オブジェクトの場合は、列挙体の静的オーディオ チャネル値のいずれかを指定します。AudioObjectType_None を指定すると、空間化されないオーディオ オブジェクトが生成されます。 |
| audioObject | ISpatialAudioObjectForHrtf** | out | アクティブ化されたインターフェイスへのポインターを受け取ります。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合、返される可能性のあるコードには、以下の表に示す値が含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| システムが同時に扱えるオーディオ オブジェクトの最大数に達しました。 | |
| 空間オーディオ ストリームに関連付けられた ISpatialAudioClient が破棄されました。 | |
| オーディオ エンドポイント デバイスが取り外されたか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効化、削除、その他の理由により使用できなくなりました。 | |
| 内部エラーが発生しました。 | |
| 空間オーディオ ストリームに関連付けられたメディアが、サポートされていない形式を使用しています。 |
解説(Remarks)
動的 ISpatialAudioObjectForHrtf とは、ActivateSpatialAudioObjectForHrtf メソッドの type パラメーターを AudioObjectType_Dynamic に設定してアクティブ化されたものを指します。クライアントには、同時にアクティブ化できる動的空間オーディオ オブジェクトの最大数に上限があります。この上限に達した後にさらにオーディオ オブジェクトをアクティブ化しようとすると、このメソッドは SPTLAUDCLNT_E_NO_MORE_OBJECTS エラーを返します。これを回避するには、各動的 ISpatialAudioObjectForHrtf が不要になった時点で Release を呼び出してリソースを解放し、再割り当てできるようにします。空間オーディオ オブジェクトの有効期間の管理について詳しくは、ISpatialAudioObjectgBase::IsActive および ISpatialAudioObjectgBase::SetEndOfStream を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ISpatialAudioObjectRenderStreamForHrtf "{E08DEEF9-5363-406E-9FDC-080EE247BBE0}"
#usecom global ISpatialAudioObjectRenderStreamForHrtf IID_ISpatialAudioObjectRenderStreamForHrtf "{}"
#comfunc global ISpatialAudioObjectRenderStreamForHrtf_ActivateSpatialAudioObjectForHrtf 10 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。