Interfaz ICodecAPI (icodecapi.h)

La interfaz ICodecAPI establece y recupera la configuración en un codificador o filtro de descodificador.

Herencia

La interfaz ICodecAPI hereda de la interfaz IUnknown.

Métodos

La interfaz ICodecAPI tiene estos métodos.

ICodecAPI::GetAllSettings El método GetAllSettings obtiene las propiedades actuales del códec y los escribe en una secuencia. (ICodecAPI::GetAllSettings)
ICodecAPI::GetDefaultValue El método GetDefaultValue obtiene el valor predeterminado de una propiedad de códec. (ICodecAPI::GetDefaultValue)
ICodecAPI::GetParameterRange El método GetParameterRange obtiene el intervalo de valores de una propiedad de códec. (ICodecAPI::GetParameterRange)
ICodecAPI::GetParameterValues El método GetParameterValues obtiene la lista de valores posibles para una propiedad de códec. (ICodecAPI::GetParameterValues)
ICodecAPI::GetValue El método ICodecAPI::GetValue obtiene el valor actual de una propiedad de códec.
ICodecAPI::IsModifiable El método IsModifiable consulta si se puede cambiar una propiedad de códec, dada la configuración actual del códec. (ICodecAPI::IsModifiable)
ICodecAPI::IsSupported El método IsSupported consulta si un códec admite una propiedad determinada. (ICodecAPI::IsSupported)
ICodecAPI::RegisterForEvent El método RegisterForEvent registra la aplicación para recibir eventos del códec. (ICodecAPI::RegisterForEvent)
ICodecAPI::SetAllDefaults El método SetAllDefaults restablece todas las propiedades del códec a sus valores predeterminados. (ICodecAPI::SetAllDefaults)
ICodecAPI::SetAllDefaultsWithNotify El método SetAllDefaultsWithNotify restablece todas las propiedades del códec a sus valores predeterminados y devuelve una lista de las propiedades que han cambiado. (ICodecAPI::SetAllDefaultsWithNotify)
ICodecAPI::SetAllSettings El método SetAllSettings lee las propiedades del códec de una secuencia y las establece en el códec. (ICodecAPI::SetAllSettings)
ICodecAPI::SetAllSettingsWithNotify El método SetAllSettingsWithNotify lee las propiedades del códec de una secuencia, las establece en el códec y devuelve una lista de las propiedades que cambiaron. (ICodecAPI::SetAllSettingsWithNotify)
ICodecAPI::SetValue El método SetValue establece el valor de una propiedad de códec. (ICodecAPI::SetValue)
ICodecAPI::SetValueWithNotify El método SetValueWithNotify establece una propiedad en un códec y devuelve una lista de otras propiedades que cambiaron como resultado. (ICodecAPI::SetValueWithNotify)
ICodecAPI::UnregisterForEvent El método UnregisterForEvent anula el registro de la aplicación para un evento de codificador especificado. (ICodecAPI::UnregisterForEvent)

Comentarios

Esta interfaz define un mecanismo genérico para establecer propiedades en un códec (codificador o descodificador). Una propiedad de códec es un par clave-valor, donde la clave es un GUID y el valor es variant. La interpretación de los datos VARIANT depende del GUID de la propiedad. Para obtener una lista de GUID de propiedad de códec, consulte Propiedades de la API de códec.

Perfiles de códec

Opcionalmente, los códecs pueden almacenar información de perfil y funcionalidad en el registro del sistema. Esta información permite a las aplicaciones consultar el dispositivo durante la enumeración del dispositivo. Los perfiles predeterminados se almacenan en la siguiente clave del Registro:

HKEY_LOCAL_MACHINE
   Software
      Classes
         CLSID
            Category
               Profiles

Cada perfil es una clave del Registro cuya cadena predeterminada es una descripción de texto del perfil. Cada valor tiene un nombre GUID, seguido de un valor de cadena que contiene el valor GUID numérico. Por ejemplo:

C++
HLKM\Software\Classes\CLSID\<category>\Profiles\DVD default "HQ DVD" REG_SZ {...} = "0" REG_SZ {...} = "1234"

donde {...} es un GUID de propiedad que la aplicación puede asignar a su interfaz de usuario. Microsoft está considerando actualmente la definición de un conjunto de perfiles estándar.

Las funcionalidades de códec predeterminadas se almacenan en HLKM\Software\Classes\CLSID< category>\Instance< Filtre CLSID>\Capabilities. Cada valor tiene un nombre GUID, seguido de un valor de cadena que contiene el valor GUID numérico. Por ejemplo:

C++
HLKM\Software\Classes\CLSID\<category>\Instance\<My DVD encoder>\Capabilities default "My DVD encoder" REG_SZ_MULTI {...}

donde {...} es un GUID de propiedad que la aplicación puede asignar a su interfaz de usuario.

Requisitos

Requisito	Value
Cliente mínimo compatible	compilación 20348 de Windows 10
Servidor mínimo compatible	compilación 20348 de Windows 10
Encabezado	icodecapi.h

Consulte también

API de codificador