IAMTimelineGroup::SetSmartRecompressFormat (método)

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

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.]

 

El SetSmartRecompressFormat método especifica un formato de compresión de vídeo que se va a usar para la recompresión inteligente.

No se admite la recompresión inteligente para grupos de audio.

Sintaxis

HRESULT SetSmartRecompressFormat(
   long *pFormat
);

Parámetros

pFormat

Puntero a una estructura que describe el formato de compresión. Actualmente, solo la estructura SCompFmt0 es válida. Debe convertir este parámetro en un puntero de tipo long.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Antes de llamar a este método, llame al método IAMTimelineGroup::SetMediaType en el mismo grupo, para especificar un formato sin comprimir.

Si el SetSmartRecompressFormat método se ejecuta correctamente, puede usar el motor de representación inteligente para generar una secuencia de vídeo comprimida. El vídeo comprimido tendrá el ancho, el alto y la velocidad de fotogramas que se especificó en el parámetro pFormat . Estos valores invalidarán los proporcionados para el formato sin comprimir en el método SetMediaType . Sin embargo, para obtener las ventajas de la recompresión inteligente, los dos formatos deben coincidir. En otras palabras, los formatos comprimidos y sin comprimir deben tener la misma altura, ancho y velocidad de fotogramas.

Si el motor de representación inteligente no puede generar el formato comprimido, generará una secuencia de vídeo sin comprimir en su lugar. Si esto ocurre, el motor de representación inteligente notifica un error de representación DEX_IDS_CANT_FIND_COMPRESSOR durante el método IRenderEngine::ConnectFrontEnd . La aplicación puede detectar este error a través del método IAMErrorLog::LogError . (Para obtener más información, consulte Registro de errores y errores de representación).

El formato de recompresión inteligente no es persistente. Si una aplicación usa la recompresión inteligente, debe establecer el formato de recompresión siempre que cargue un archivo de proyecto.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Value
Encabezado	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IAMTimelineGroup (Interfaz)

Códigos de error y éxito

Motor de representación inteligente

Escribir un proyecto en un archivo