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

IDirectSound

COM
IID279afa83-4981-11ce-a521-0020af0be560継承元IUnknown自前メソッド開始 vtbl3

メソッド 8

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

vtbl 3 HRESULT CreateSoundBuffer(DSBUFFERDESC* pcDSBufferDesc, IDirectSoundBuffer** ppDSBuffer, IUnknown* pUnkOuter)
pcDSBufferDescDSBUFFERDESC*in作成するサウンドバッファの形式・容量・能力フラグを指定するDSBUFFERDESC構造体へのポインタ。
ppDSBufferIDirectSoundBuffer**out生成されたIDirectSoundBufferインターフェイスの受け取り先。要Release。
pUnkOuterIUnknown*inoptionalCOMアグリゲーション用の外部IUnknown。通常はNULL。
vtbl 4 HRESULT GetCaps(DSCAPS* pDSCaps)
pDSCapsDSCAPS*outデバイスの能力情報を受け取るDSCAPS構造体へのポインタ。dwSizeを事前設定する。
vtbl 5 HRESULT DuplicateSoundBuffer(IDirectSoundBuffer* pDSBufferOriginal, IDirectSoundBuffer** ppDSBufferDuplicate)
pDSBufferOriginalIDirectSoundBuffer*in複製元となるIDirectSoundBufferへのポインタ。
ppDSBufferDuplicateIDirectSoundBuffer**out複製されたバッファ(波形メモリは共有)の受け取り先。要Release。
vtbl 6 HRESULT SetCooperativeLevel(HWND hwnd, DWORD dwLevel)
hwndHWNDin協調レベルを関連付けるアプリケーションのウィンドウハンドル。
dwLevelDWORDin協調レベル(DSSCL_NORMAL/PRIORITY/EXCLUSIVE/WRITEPRIMARY)を指定する値。
vtbl 7 HRESULT Compact()
vtbl 8 HRESULT GetSpeakerConfig(DWORD* pdwSpeakerConfig)
pdwSpeakerConfigDWORD*out現在のスピーカー構成(DSSPEAKER_*)を受け取るポインタ。
vtbl 9 HRESULT SetSpeakerConfig(DWORD dwSpeakerConfig)
dwSpeakerConfigDWORDin設定するスピーカー構成(DSSPEAKER_STEREO/SURROUNDなど)。
vtbl 10 HRESULT Initialize(GUID* pcGuidDevice)
pcGuidDeviceGUID*inoptional使用するサウンドデバイスのGUIDへのポインタ。NULLで既定デバイスを使用。

HSP用 COM定義

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

出力引数:
#define global IID_IDirectSound "{279AFA83-4981-11CE-A521-0020AF0BE560}"
#usecom global IDirectSound IID_IDirectSound "{47D4D946-62E8-11CF-93BC-444553540000}"
#comfunc global IDirectSound_CreateSoundBuffer     3 var,sptr,sptr
#comfunc global IDirectSound_GetCaps               4 var
#comfunc global IDirectSound_DuplicateSoundBuffer  5 sptr,sptr
#comfunc global IDirectSound_SetCooperativeLevel   6 sptr,int
#comfunc global IDirectSound_Compact               7
#comfunc global IDirectSound_GetSpeakerConfig      8 var
#comfunc global IDirectSound_SetSpeakerConfig      9 int
#comfunc global IDirectSound_Initialize            10 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。