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

IHardwareAudioEngineBase

COM
IIDeddce3e4-f3c1-453a-b461-223563cbd886継承元IUnknown自前メソッド開始 vtbl3

メソッド 5

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

vtbl 3 HRESULT GetAvailableOffloadConnectorCount(LPWSTR _pwstrDeviceId, DWORD _uConnectorId, DWORD* _pAvailableConnectorInstanceCount)
_pwstrDeviceIdLPWSTRin対象デバイスを識別するデバイスID文字列(LPWSTR)。
_uConnectorIdDWORDin対象とするコネクタのID。デバイス内の特定の接続端子を指定する。
_pAvailableConnectorInstanceCountDWORD*out利用可能なオフロードコネクタインスタンス数を受け取るDWORDへのポインタ。
vtbl 4 HRESULT GetEngineFormat(IMMDevice* pDevice, BOOL _bRequestDeviceFormat, WAVEFORMATEX** _ppwfxFormat)
pDeviceIMMDevice*in対象オーディオエンドポイントを表すIMMDeviceインターフェイスへのポインタ。
_bRequestDeviceFormatBOOLinTRUEでデバイスフォーマット、FALSEでミックスフォーマットを要求するBOOL値。
_ppwfxFormatWAVEFORMATEX**inout取得したオーディオフォーマットを受け取るWAVEFORMATEXポインタのアドレス。呼び出し側が解放する。
vtbl 5 HRESULT SetEngineDeviceFormat(IMMDevice* pDevice, WAVEFORMATEX* _pwfxFormat)
pDeviceIMMDevice*in対象オーディオエンドポイントを表すIMMDeviceインターフェイスへのポインタ。
_pwfxFormatWAVEFORMATEX*inout設定するデバイスフォーマットを記述したWAVEFORMATEX構造体へのポインタ。
vtbl 6 HRESULT SetGfxState(IMMDevice* pDevice, BOOL _bEnable)
pDeviceIMMDevice*in対象オーディオエンドポイントを表すIMMDeviceインターフェイスへのポインタ。
_bEnableBOOLinグローバルエフェクト(GFX)を有効にするか指定するBOOL値。TRUEで有効化。
vtbl 7 HRESULT GetGfxState(IMMDevice* pDevice, BOOL* _pbEnable)
pDeviceIMMDevice*in対象オーディオエンドポイントを表すIMMDeviceインターフェイスへのポインタ。
_pbEnableBOOL*outグローバルエフェクト(GFX)の現在の有効状態を受け取るBOOLへのポインタ。

HSP用 COM定義

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

出力引数:
#define global IID_IHardwareAudioEngineBase "{EDDCE3E4-F3C1-453A-B461-223563CBD886}"
#usecom global IHardwareAudioEngineBase IID_IHardwareAudioEngineBase "{}"
#comfunc global IHardwareAudioEngineBase_GetAvailableOffloadConnectorCount  3 wstr,int,var
#comfunc global IHardwareAudioEngineBase_GetEngineFormat                    4 sptr,int,var
#comfunc global IHardwareAudioEngineBase_SetEngineDeviceFormat              5 sptr,var
#comfunc global IHardwareAudioEngineBase_SetGfxState                        6 sptr,int
#comfunc global IHardwareAudioEngineBase_GetGfxState                        7 sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。