PKEY_AudioEndpoint_FullRangeSpeakers

PKEY_AudioEndpoint_FullRangeSpeakers屬性會指定連接到音訊端點裝置之全範圍喇叭的通道組態遮罩。 遮罩會指出完整範圍喇叭的實體設定，並指定將這些喇叭的通道指派給這些說話者。

PROPVARIANT結構的vt成員會設定為 VT_UI4。

PROPVARIANT結構的uintVal成員包含轉換成UINT類型的通道組態遮罩。

全範圍喇叭能夠播放音效，範圍從 Bass 到 treble。 一般而言，較大的喇叭是完整的範圍，但較小的喇叭明顯無法播放 Bass 音效。 在 Windows Vista 中，音訊引擎會使用此屬性來管理音訊端點裝置所播放之音訊輸出資料流程中的 Bass 層級。

此屬性的通道組態遮罩格式與 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。 此遮罩表示前方、右上、右上方、側左和右邊喇叭存在，再加上副標題。 如果前端和右上方喇叭夠大，無法產生 Bass 音效，但較小的前端和側邊喇叭則不是，則PKEY_AudioEndpoint_FullRangeSpeakers屬性的通道組態遮罩是KSAUDIO_SPEAKER_STEREO，這只表示前端和右上方喇叭。 通道組態遮罩KSAUDIO_SPEAKER_5POINT1和KSAUDIO_SPEAKER_STEREO定義于標頭檔 Ksmedia.h 中。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	Mmdeviceapi.h

另請參閱

音訊端點屬性

核心音訊屬性

PKEY_AudioEndpoint_PhysicalSpeakers屬性