KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST屬性是篩選屬性,其值為套用至特定 KS 釘選處理站的音訊效果類型清單,適用于特定音訊訊號處理路徑。
使用量摘要資料表
使用量摘要資料表
Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
---|---|---|---|---|
是 |
否 |
透過篩選實例 (釘選處理站) |
KSP_PIN |
KSP_PINMODE |
屬性值是零個或多個音訊效果類型 GUI (D 的陣列,例如,AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) KSP_PINMODE 結構所 識別的針腳訊號處理路徑中。
注意 這個屬性不得設定KSPROPERTY_TYPE_TOPOLOGY旗標位。
傳回值
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST屬性要求會傳回STATUS_SUCCESS,表示它已順利完成。 否則,這個屬性要求會傳回適當的錯誤狀態碼。
備註
如果音訊驅動程式使用 Microsoft 的一般 Proxy APO 來擷取 KS 針腳之不同訊號處理路徑中包含的音訊效果,則必須支援此屬性。 泛型 Proxy APO 包含在 msapofxproxy.dll 檔案中。 音訊驅動程式可以在音訊驅動程式中完成所有訊號處理時,或在對應的數位訊號處理器中 (DSP) 硬體元件中,而不需要在 APO 中完成任何處理時,就可以使用此一般 Proxy APO。 在此情況下,APO 的唯一功能是向音訊系統報告訊號處理效果。
泛型 Proxy APO 會從音訊驅動程式接收 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST ,並使用它向音訊系統報告效果。 泛型 Proxy APO 假設啟用 KS 針腳篩選介面時,效果清單不會變更。
如果屬性描述項指定不支援 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST的 KS 針腳,則驅動程式必須傳回STATUS_NOT_SUPPORTED。
如果屬性描述項指定驅動程式不支援的 AudioProcessingMode 值,則驅動程式必須傳回STATUS_INVALID_PARAMETER。 請注意,音訊驅動程式必須支援 KSPROPERTY_AUDIOSIGNALPROCESSING_MODES 屬性,才能指出其支援的音訊訊號處理模式。
規格需求
版本 |
Windows 8.1 |
標頭 |
Msapofxproxy.h |