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>\功能。 每個值都有 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 |