Поделиться через

Интерфейс 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"
где {...} — это GUID свойства, который приложение может сопоставить со своим пользовательским интерфейсом. В настоящее время корпорация Майкрософт рассматривает определение набора стандартных профилей.

Возможности кодеков по умолчанию хранятся в разделе 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 {...}
где {...} — это GUID свойства, который приложение может сопоставить со своим пользовательским интерфейсом.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть icodecapi.h

См. также раздел

API кодировщика