音訊端點屬性

  • 發行項

頭檔 Mmdeviceapi.h 定義 Windows Vista 和更新版本中音訊端點裝置的數個屬性。 Windows 音訊服務會設定這些屬性的值。 用戶端可以讀取這些屬性，但不應該加以設定。 屬性值會儲存為 PROPVARIANT 結構。

讀取音頻輸入裝置屬性的建議方式是使用 Windows.Devices.Enumeration 命名空間中的 API。 Windows 市集應用程式和傳統型應用程式支援這些 API。 如需使用 IMMDevice 介面讀取裝置屬性的現有傳統型應用程式，請參閱裝置屬性。 Windows 市集應用程式不支援 IMMDevice 。

如需示範如何存取音訊端點裝置屬性的程式代碼範例，請參閱下列主題：

如需 PROPVARIANT 的相關信息，請參閱 Windows SDK 檔。

下列屬性專屬於音訊端點裝置。

屬性 說明
PKEY_AudioEndpoint_Association 將核心串流 （KS） 針腳類別與音訊端點裝置產生關聯。
PKEY_AudioEndpoint_ControlPanelPageProvider 指定音訊端點裝置之裝置屬性擴充功能的已註冊提供者 CLSID。
PKEY_AudioEndpoint_Disable_SysFx 指出是否在流向音訊端點裝置的共用模式數據流中啟用系統效果。
PKEY_AudioEndpoint_FormFactor 指出音訊端點裝置的實體屬性。
PKEY_AudioEndpoint_FullRangeSpeakers 指定連接到音訊端點裝置之全範圍喇叭的通道組態遮罩。
PKEY_AudioEndpoint_GUID 提供對應至音頻端點裝置的 DirectSound 裝置識別碼。
PKEY_AudioEndpoint_PhysicalSpeakers 定義音訊端點裝置的實體喇叭組態。
PKEY_AudioEngine_DeviceFormat 指定裝置格式，這是音訊引擎針對流向音訊端點裝置或從音訊端點裝置流動的共用模式數據流所使用的格式。
PKEY_AudioEngine_OEMFormat 指定用於轉譯或擷取數據流之裝置的預設格式。 值會由 .inf 檔案中的 OEM 填入。
PKEY_AudioEndpoint_Supports_EventDriven_Mode 指出端點是否支援事件驅動模式。 值會由 .inf 檔案中的 OEM 填入。
PKEY_AudioEndpoint_JackSubType 包含音訊端點裝置的輸出類別 GUID。

核心音訊 API 支援不適用於音訊端點裝置的其他屬性。 如需這些其他屬性的詳細資訊，請參閱 裝置屬性。

音訊端點裝置

程式設計參考