Compartir a través de


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