Interfaz ICodecAPI (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

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

Nota:

Las API declaradas en strmif.h no son compatibles con las aplicaciones de Plataforma universal de Windows (UWP). Para usar ICodecAPI en una aplicación para UWP, use la versión declarada en icodecapi.h.

Herencia

La interfaz ICodecAPI hereda de la interfaz IUnknown . ICodecAPI también tiene estos tipos de miembros:

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 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

Cliente mínimo compatible	Windows XP con SP2 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)

Consulte también

Configuración del descodificador para Windows Media Center Edition

API de codificador