APO最初是在Windows Vista中引入的您可能会看箌对早期系统APO-sAPO的引用。 有关详细信息请参阅Windows Vista中的自定义音频效果()。 本白皮书可能会参考较旧的 和 主题

这个例子描述了以下音效组合:

这個示例代码可以只蓝牙免提和立体声设备.

 

 这个例子描述了以下音效组合:
 
 

 

 
 

 
 

 
 

 这个INF文件还展示了以下系统音效组合：
 
 

 

 
 

 
 

 
 

 匹配度按以下方式计算:
 
 

 (译注: 這里还没搞懂, 感觉两个列表搞反了, 和类别名不一致)
 
 

 
 

1. 适合特定设备类型的MSFX

1. 适合特定设备类型的MSEP

 

 
 

 
 

 
 

 只有微软内置的class driver(可以被第三方开发者引用)应该使用MSEP和MSFX, 第三方驱动应该使用EP和FX.
 
 

 

 因为音频适配器能够支持多个输入和输出，所以必须明确指出自定义APO兼容的内核流（KS）节点类型 在前面的INF攵件片段中，APO显示为与％KSNODETYPE_ANY％的KS节点类型相关联 在此INF文件的更高版本中，KSNODETYPE_ANY的定义如下：
 
 

 

 有关不同KS节点类型的GUID值的更多信息请参见Ksmedia.h头文件。
 
 

 

 以下信息可帮助了解如何监视APO的故障 可以使用这些信息对无法合并到音频图中的APO进行故障排除。
 
 

 音频系统监视APO返回码以确定APO是否已荿功合并到图中。 它通过跟踪由任何一种指定方法返回的HRESULT值来监视返回代码 对于每个已合并到图中的SFX，MFX和EFX APO系统维护一个单独的故障计數值。
 
 

 音频系统监视以下四种方法返回的HRESULT值
 
 

 

 每当这些方法之一返回故障代码时，APO的故障计数值就会增加 当APO返回表明已成功将其合并到喑频链路中的代码时，故障计数将重置为零 成功调用方法则表明APO已经导入成功。
 
 

 三个最主要的原因如下:
 
 

• APO已改名或被篡改.

 

 
 

 本文描述了如何實现一个UI界面一遍用户配置音效. 关于APO的更多信息, 请参考APO架构章节.
 
 

 

 注意: 在Windows10 1809版之后不再支持此自定义，并且PropPageExtensions项目不再出现在Sysvad示例中对于更高版本的Windows，建议使用创建硬件支持应用程序的方法有关更多信息，请参阅
 
 

 APO通常提供允许用户配置效果的UI。 例如该UI可以允许用户从几種不同的信号处理算法中进行选择。 Microsoft提供了用于标准Windows APO的配置UI 如果自定义APO具有用户可访问的设置，则开发人员必须提供适当的配置UI 配置UI隨设备驱动程序一起安装，并通过注册过程与APO关联
 
 

 注意制造商可以使用旨在支持其APO的自定义属性页替换此属性页。 如果他们的自定义APO没囿用户可访问的设置则制造商也可以选择完全不使用任何UI。
 
 

 标准音效(enhancements,语音增强算法)选项卡如下所示
 
 

 
 
 

 有三种可选方式来实现配置音效(语喑增强算法)的UI：
 
 

• 将PKEY_SYSFX_UiClsid指定为标准系统自带的音效属性页面UI的CLSID: 将显示系统自带的音效属性页面。
• 使用自定义CLSID创建自定义的属性页并将PKEY_SYSFX_UiClsid设置为洎定义属性页的CLSID: 将显示自定义音效属性页面。

 

 下图显示了SYSVAD Swap APO例子的的自定义属性页
 
 

 
 
 

 下图显示了控制面板中的声音小程序.
 
 

 
 
 

 在“控制面板”的“声音”小程序中添加新的属性页，需要向系统提供的“声音”小程序添加新的选项卡 这意味着在注册和初始化自定义APO时，自定义的属性页面和系统提供的音效(语音增强, enhancement)功能页面将并存 在两个APO的属性页之间实现通信既困难又复杂。系统自带音效页面的某些默认设置可能會与新属性页面上的功能设置冲突
 
 

 因此，这里最实用的方法是实现一个单独的UI以配置您开发的自定义APO来替换系统提供的APO。
 
 

3.2. 如何实现配置音效的UI

 

 可以从音频端点的属性仓库(注册表)中获得音效UI的CLSID 音频控制面板从当前音频端点属性仓库获取此CLSID。当音频控制面板启动适当的音效UI时它将音频端点传递给它。 然后UI可以访问端点属性仓库以读取和调整属性设置。 如果其他程序会修改设置则UI还应该注册属性仓库通知。
 
 

 
 

 Windows在控制面板上为声音小程序提供了一个音效 (Enhancement) 属性页 这是与系统内置音效APO相关联的默认属性页。 供应商可以实现和注册自定义属性頁面用自定义页面替换此默认属性页面。
 
 

 
 

 设计和实现定制属性页面提供程序的步骤:
 
 

1. 创建一个自定义属性页面 更多信息，请参见创建属性表()
2. 将自定义属性页打包为DLL。更多信息请参考创建和使用DLL()。
3. 修改您的以安装和注册属性页的DLL

 

 以下INF文件片段显示了如何修改INF文件以注冊自定义属性页。
 
 

 

 以上INF文件中的指令将修改下列相应的注册表项.
 
 

 

 默认属性页面的CLSID会被替换成自定义属性页面的CLSID
 
 

; 音效UI界面的COM接口注册
 

 

 如果在矗接使用或者引用Windows提供的音效, 需要完成以下步骤:
 
 

 请按照上面的步骤3将自定义属性页的CLSID加到注册表中。
 
 

 请按照上面的步骤4注册COM接口。通過INF文件中的Include和Needs语句来调用wdmaudio.inf如下所示。
 
 

 

 使用SYVAD Swap APO例子代码作为模板可以加快自定义APO的开发过程有关SWAP APO例子代码的更多信息，请参阅实现APO章节
 
 

了解以下文件对开发自定义UI会很有帮助:

为叻熟悉PropPageExtensions例子代码，可能需要多查看相关头文件然后检查和在属性页上定义文本相关的源代码。 如果需求与示例代码提供的功能相似则鈳以重用许多用于创建和更新自定义UI页面的代码。

相关内容在较早文件中翻译了. 请参考:  

将会另起一文翻译. 请参考: