Método IVMRFilterConfig::SetRenderingPrefs (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.

El SetRenderingPrefs método establece varias preferencias de aplicación relacionadas con la representación de vídeo.

Sintaxis

HRESULT SetRenderingPrefs(
  [in] DWORD dwRenderFlags
);

Parámetros

[in] dwRenderFlags

Palabra doble que contiene un OR bit a bit de los valores VMRRenderPrefs que especifican las preferencias de representación.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Código devuelto	Descripción
VFW_E_WRONG_STATE	No hay ningún asignador-moderador presente.
E_INVALIDARG	dwRenderFlags no es válido.

Comentarios

Este método llama a a través del método IVMRImagePresenterConfig::SetRenderingPrefs del asignador-moderador. (El asignador-moderador predeterminado expone IVMRImagePresenterConfig. Los moderadores de asignadores personalizados también pueden exponer esta interfaz si lo desea). Si VMR-7 aún no ha creado el asignador-moderador predeterminado, o si la aplicación proporcionó un asignador-moderador personalizado que no admite IVMRImagePresenterConfig, este método devuelve VFW_E_WRONG_STATE. Para crear el asignador-moderador predeterminado, llame a IVMRFilterConfig::SetRenderingMode con el valor VMRMode_Windowed o VMRMode_Windowed.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IVMRFilterConfig (interfaz)

IVMRFilterConfig::GetRenderingPrefs

Uso del representador de mezcla de vídeos