Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IAMDirectSound

IAMDirectSound

COM
📘 Microsoft Learn (日本語) · English
IID546f4260-d53e-11cf-b3f0-00aa003761c5継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IAMDirectSound インターフェイスは、DirectSound のオーディオ再生を制御するために、どのウィンドウがフォーカスを持つかを指定します。

メソッド 8

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

vtbl 3 HRESULT GetDirectSoundInterface(IDirectSound** lplpds)

GetDirectSoundInterface メソッドは実装されていません。

lplpdsIDirectSound**out取得したIDirectSoundインターフェイスのポインタを受け取る出力ポインタ。使用後にReleaseが必要。

戻り値

E_NOTIMPL を返します。

vtbl 4 HRESULT GetPrimaryBufferInterface(IDirectSoundBuffer** lplpdsb)

GetPrimaryBufferInterface メソッドは実装されていません。

lplpdsbIDirectSoundBuffer**out取得したプライマリIDirectSoundBufferのポインタを受け取る出力ポインタ。使用後にReleaseが必要。

戻り値

E_NOTIMPL を返します。

vtbl 5 HRESULT GetSecondaryBufferInterface(IDirectSoundBuffer** lplpdsb)

GetSecondaryBufferInterface メソッドは実装されていません。

lplpdsbIDirectSoundBuffer**out取得したセカンダリIDirectSoundBufferのポインタを受け取る出力ポインタ。使用後にReleaseが必要。

戻り値

E_NOTIMPL を返します。

vtbl 6 HRESULT ReleaseDirectSoundInterface(IDirectSound* lpds)

ReleaseDirectSoundInterface メソッドは実装されていません。

lpdsIDirectSound*in解放するIDirectSoundインターフェイスへの入力ポインタ。

戻り値

E_NOTIMPL を返します。

vtbl 7 HRESULT ReleasePrimaryBufferInterface(IDirectSoundBuffer* lpdsb)

ReleasePrimaryBufferInterface メソッドは実装されていません。

lpdsbIDirectSoundBuffer*in解放するプライマリIDirectSoundBufferへの入力ポインタ。

戻り値

E_NOTIMPL を返します。

vtbl 8 HRESULT ReleaseSecondaryBufferInterface(IDirectSoundBuffer* lpdsb)

ReleaseSecondaryBufferInterface メソッドは実装されていません。

lpdsbIDirectSoundBuffer*in解放するセカンダリIDirectSoundBufferへの入力ポインタ。

戻り値

E_NOTIMPL を返します。

vtbl 9 HRESULT SetFocusWindow(HWND param0, BOOL param1)

SetFocusWindow メソッドは、サウンド再生を処理するウィンドウを指定します。

param0HWNDinオーディオフォーカスを関連付けるウィンドウのハンドルを指定する入力値。
param1BOOLinフォーカスウィンドウの挙動を指定するブール値。TRUEで有効化する。

戻り値

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

vtbl 10 HRESULT GetFocusWindow(HWND* param0, BOOL* param1)

GetFocusWindow メソッドは、サウンド再生を処理しているウィンドウを取得します。

param0HWND*inout現在フォーカスに関連付けられているウィンドウハンドルを受け取る出力ポインタ。
param1BOOL*inoutフォーカスウィンドウの設定状態を受け取る出力ポインタ。

戻り値

HRESULT 値を返します。とり得る値には次のものがあります。

リターンコード 説明
E_FAIL
 失敗しました。
E_POINTER
 NULL ポインター引数です。
S_OK
 メソッドが成功しました。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IAMDirectSound "{546F4260-D53E-11CF-B3F0-00AA003761C5}"
#usecom global IAMDirectSound IID_IAMDirectSound "{}"
#comfunc global IAMDirectSound_GetDirectSoundInterface          3 sptr
#comfunc global IAMDirectSound_GetPrimaryBufferInterface        4 sptr
#comfunc global IAMDirectSound_GetSecondaryBufferInterface      5 sptr
#comfunc global IAMDirectSound_ReleaseDirectSoundInterface      6 sptr
#comfunc global IAMDirectSound_ReleasePrimaryBufferInterface    7 sptr
#comfunc global IAMDirectSound_ReleaseSecondaryBufferInterface  8 sptr
#comfunc global IAMDirectSound_SetFocusWindow                   9 sptr,int
#comfunc global IAMDirectSound_GetFocusWindow                   10 sptr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。