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 [デスクトップ アプリのみ]
ヘッダー	Mmdeviceapi.h

関連項目

オーディオ エンドポイントのプロパティ

コア オーディオのプロパティ

PKEY_AudioEndpoint_PhysicalSpeakers プロパティ