PKEY_AudioEndpoint_FullRangeSpeakers
PKEY_AudioEndpoint_FullRangeSpeakers プロパティは、オーディオ エンドポイント デバイスに接続されている全範囲スピーカーのチャネル構成マスクを指定します。 マスクは、フルレンジ スピーカーの物理的な構成を示し、それらのスピーカーへのチャネルの割り当てを指定します。
PROPVARIANT 構造体の vt メンバーは、VT_UI4に設定されています。
PROPVARIANT 構造体の uintVal メンバーには、UINT 型にキャストされるチャネル構成マスクが含まれています。
フルレンジスピーカーは、低音から高音まで、全範囲のサウンドを再生することができます。 通常、より大きなスピーカーはフルレンジですが、小さいスピーカーはベースサウンドを再生する能力が大幅に低くなります。 Windows Vista では、オーディオ エンジンはこのプロパティを使用して、オーディオ エンドポイント デバイスによって再生されるオーディオ出力ストリームのベース レベルを管理します。
このプロパティのチャネル構成マスクは、 PKEY_AudioEndpoint_PhysicalSpeakers プロパティのチャネル構成マスクと同じ形式です。 チャネル構成マスクの詳細については、「 KSPROPERTY_AUDIO_CHANNEL_CONFIG」を参照してください。
システムは、ユーザーから PKEY_AudioEndpoint_FullRangeSpeakers プロパティのチャネル構成マスクを取得します。 ユーザーは、Windows マルチメディア コントロール パネルを使用してこの情報を入力Mmsys.cpl。 Mmsys.cplの詳細については、Windows DDK のドキュメントを参照してください。
オーディオ エンドポイント デバイスの PKEY_AudioEndpoint_FullRangeSpeakers プロパティのチャネル構成マスクは、同じデバイスの PKEY_AudioEndpoint_PhysicalSpeakers プロパティのチャネル構成マスクのサブセットです。
たとえば、オーディオ エンドポイント デバイスが 5.1 のサラウンド サウンド スピーカーのセットを駆動する場合、PKEY_AudioEndpoint_PhysicalSpeakers プロパティのチャネル構成マスクはKSAUDIO_SPEAKER_5POINT1。 このマスクは、フロント・レフト、フロント・ライト、フロント・センター、サイド・レフト、およびサイド・ライト・スピーカーとサブウーファーの存在を示します。 フロント左スピーカーとフロントライトスピーカーがベースサウンドを生成するのに十分な大きさで、フロントセンターとサイドスピーカーが小さい場合は、PKEY_AudioEndpoint_FullRangeSpeakersプロパティのチャネル構成マスクはKSAUDIO_SPEAKER_STEREOされ、フロント左右のスピーカーのみが示されます。 チャネル構成マスクKSAUDIO_SPEAKER_5POINT1とKSAUDIO_SPEAKER_STEREOは、ヘッダー ファイル Ksmedia.h で定義されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| ヘッダー |
|
関連項目