Interfaz ICodecAPI (strmif.h)
[Ya no se recomienda el uso de la característica CodecAPI con DirectShow. DirectShow ha reemplazado el uso de MediaPlayer, IMFMediaEnginey captura de audio y vídeo en Media Foundation. Esas características se han optimizado para Windows 11 y Windows 10. En lugar de DirectShow, Microsoft recomienda encarecidamente cuando sea posible que el nuevo código use MediaPlayer, IMFMediaEnginey captura de audio y vídeo en Media Foundation. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El ICodecAPI conjuntos de interfaz y recupera la configuración en un filtro de codificador o descodificador.
Nota
Las API declaradas en strmif.h no son compatibles con las aplicaciones de la Plataforma universal de Windows (UWP). Para usar ICodecAPI en una aplicación para UWP, usa 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 las 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 han cambiado. (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) |
Observaciones
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 un VARIANT. La interpretación de los datos de VARIANT depende del GUID de propiedad. Para obtener una lista de guides de propiedad de códec, consulte Propiedades de la API de códec.
Perfiles de códec de
Los códecs pueden almacenar opcionalmente 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 ProfilesCada 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"
|
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 {...}
|
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP con SP2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows Server 2003 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de | Windows |
| encabezado de | strmif.h (include Dshow.h) |