ICodecAPI 接口 (icodecapi.h)
ICodecAPI 接口设置和检索编码器或解码器筛选器上的设置。
继承
ICodecAPI 接口继承自 IUnknown 接口。
方法
ICodecAPI 接口具有以下方法。
| ICodecAPI：：GetAllSettings GetAllSettings 方法获取编解码器的当前属性并将其写入流。 (ICodecAPI：：GetAllSettings) |
| ICodecAPI：：GetDefaultValue GetDefaultValue 方法获取编解码器属性的默认值。 (ICodecAPI：：GetDefaultValue) |
| ICodecAPI：：GetParameterRange GetParameterRange 方法获取编解码器属性的值范围。 (ICodecAPI：：GetParameterRange) |
| ICodecAPI：：GetParameterValues GetParameterValues 方法获取编解码器属性的可能值列表。 (ICodecAPI：：GetParameterValues) |
| ICodecAPI：：GetValue ICodecAPI：：GetValue 方法获取编解码器属性的当前值。 |
| ICodecAPI：：IsModifiable 根据编解码器的当前配置，IsModifiable 方法查询编解码器属性是否可以更改。 (ICodecAPI：：IsModifiable) |
| ICodecAPI：：IsSupported IsSupported 方法查询编解码器是否支持给定属性。 (ICodecAPI：：IsSupported) |
| ICodecAPI：：RegisterForEvent RegisterForEvent 方法注册应用程序以从编解码器接收事件。 (ICodecAPI：：RegisterForEvent) |
| ICodecAPI：：SetAllDefaults SetAllDefaults 方法将所有编解码器属性重置为其默认值。 (ICodecAPI：：SetAllDefaults) |
| ICodecAPI：：SetAllDefaultsWithNotify SetAllDefaultsWithNotify 方法将所有编解码器属性重置为其默认值，并返回已更改的属性列表。 (ICodecAPI：：SetAllDefaultsWithNotify) |
| ICodecAPI：：SetAllSettings SetAllSettings 方法从流中读取编解码器属性，并在编解码器上设置这些属性。 (ICodecAPI：：SetAllSettings) |
| ICodecAPI：：SetAllSettingsWithNotify SetAllSettingsWithNotify 方法从流中读取编解码器属性，在编解码器上设置它们，并返回已更改的属性列表。 (ICodecAPI：：SetAllSettingsWithNotify) |
| ICodecAPI：：SetValue SetValue 方法设置编解码器属性的值。 (ICodecAPI：：SetValue) |
| ICodecAPI：：SetValueWithNotify SetValueWithNotify 方法在编解码器上设置属性，并返回结果更改的其他属性的列表。 (ICodecAPI：：SetValueWithNotify) |
| ICodecAPI：：UnregisterForEvent UnregisterForEvent 方法取消注册指定编码器事件的应用程序。 (ICodecAPI：：UnregisterForEvent) |
注解
此接口定义一种通用机制，用于设置编解码器 (编码器或解码器) 的属性。 编解码器属性是键/值对，其中键为 GUID，值为 VARIANT。 VARIANT 数据的解释取决于属性 GUID。 有关编解码器属性 GUID 的列表，请参阅 编解码器 API 属性。
编解码器配置文件
编解码器可以选择在系统注册表中存储配置文件和功能信息。 此信息使应用程序能够在设备枚举期间查询设备。 默认配置文件存储在以下注册表项中：HKEY_LOCAL_MACHINE Software Classes CLSID Category Profiles每个配置文件都是一个注册表项，其默认字符串是配置文件的文本说明。 每个值都有一个 GUID 名称，后跟一个包含数字 GUID 值的字符串值。 例如：
| C++ |
|---|
HLKM\Software\Classes\CLSID\<category>\Profiles\DVD
default "HQ DVD"
REG_SZ {...} = "0"
REG_SZ {...} = "1234"
|
默认编解码器功能存储在 HLKM\Software\Classes\CLSID<category>\Instance<筛选 CLSID>\Capabilities。 每个值都有一个 GUID 名称，后跟一个包含数字 GUID 值的字符串值。 例如：
| C++ |
|---|
HLKM\Software\Classes\CLSID\<category>\Instance\<My DVD encoder>\Capabilities
default "My DVD encoder"
REG_SZ_MULTI {...}
|
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10内部版本 20348 |
| 最低受支持的服务器 | Windows 10内部版本 20348 |
| 标头 | icodecapi.h |