ホーム › Media.Audio › IAudioChannelConfig
IAudioChannelConfig
COM公式ドキュメント
IAudioChannelConfig インターフェイスは、ハードウェアのチャネル構成コントロールへのアクセスを提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
SetChannelConfig メソッドは、チャネル構成コントロールにチャネル構成マスクを設定します。
| dwConfig | DWORD | in | チャネル構成マスク。 |
| pguidEventContext | GUID* | inoptional | IControlChangeNotify::OnNotify メソッドのコンテキスト値です。このパラメーターは、イベントコンテキスト GUID を指します。SetChannelConfig の呼び出しによってチャネル構成コントロールの状態が変化した場合、そのコントロールに IControlChangeNotify インターフェイスを登録しているすべてのクライアントが通知を受け取ります。OnNotify メソッドの実装において、クライアントはイベントコンテキスト GUID を調べることで、コントロール変更イベントの発生元が自分自身か他のクライアントかを判別できます。呼び出し側がこのパラメーターに NULL ポインターを指定した場合、そのクライアントの通知メソッドは NULL のコンテキストポインターを受け取ります。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合、戻り値には次の表に示す値が含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| メモリが不足しています。 |
解説(Remarks)
チャネル構成マスクについては、Windows DDK ドキュメントの KSPROPERTY_AUDIO_CHANNEL_CONFIG プロパティの説明を参照してください。
GetChannelConfig メソッドは、チャネル構成コントロールから現在のチャネル構成マスクを取得します。
| pdwConfig | DWORD* | out | 現在のチャネル構成マスクの値がメソッドによって書き込まれる DWORD 変数へのポインター。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合、戻り値には次の表に示す値が含まれますが、これらに限定されません。
| Return code | Description |
|---|---|
| ポインター pdwConfig が NULL です。 |
解説(Remarks)
チャネル構成マスクについては、Windows DDK ドキュメントの KSPROPERTY_AUDIO_CHANNEL_CONFIG プロパティの説明を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IAudioChannelConfig "{BB11C46F-EC28-493C-B88A-5DB88062CE98}" #usecom global IAudioChannelConfig IID_IAudioChannelConfig "{}" #comfunc global IAudioChannelConfig_SetChannelConfig 3 int,var #comfunc global IAudioChannelConfig_GetChannelConfig 4 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IAudioChannelConfig "{BB11C46F-EC28-493C-B88A-5DB88062CE98}" #usecom global IAudioChannelConfig IID_IAudioChannelConfig "{}" #comfunc global IAudioChannelConfig_SetChannelConfig 3 int,sptr #comfunc global IAudioChannelConfig_GetChannelConfig 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。