KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY プロパティは、KSPROPERTY_AUDIO_CHANNEL_CONFIG と共に使用して、ハードウェアアクセラレータ 3D オーディオ用の DirectSound speaker-configuration プロパティを実装します。 これは、DAC ノード (KSNODETYPE_DAC) と 3D ノード (KSNODETYPE_3D_EFFECTS) の省略可能なプロパティです。
用法の要点テーブル
Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
---|---|---|---|---|
はい |
はい |
ピン/フィルター |
LONG |
プロパティ値 (操作データ) は LONG 型で、スピーカー ジオメトリを指定します。 この値は、ヘッダー ファイル Ksmedia.h で定義されている次のいずれかの定数に設定できます。
KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX
上記のパラメーターは、IDirectSound::GetSpeakerConfig メソッド (Microsoft Windows SDK ドキュメントを参照) で使用され、ヘッダー ファイル Dsound.h で定義されている、次の値と意味は同等です (ただし、値は等しくありません)。
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX
戻り値
KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は適切なエラー状態コードを返します。
解説
DirectSound は KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY を、DAC ノードでは filter プロパティとして、3D ノードでは pin プロパティとして扱います。
詳細については、「DirectSound Speaker-Configuration の設定」を参照してください。
要件
ヘッダー |
ksmedia.h (Ksmedia.h をインクルード) |