Método IVMRImagePresenter::P resentImage (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 PresentImage método se llama precisamente en el momento en que se debe presentar este fotograma de vídeo.

Sintaxis

HRESULT PresentImage(
  [in] DWORD_PTR           dwUserID,
  [in] VMRPRESENTATIONINFO *lpPresInfo
);

Parámetros

[in] dwUserID

Un DWORD_PTR definido por la aplicación que identifica de forma única esta instancia de VMR en escenarios en los que se usan varias instancias de VMR con una sola instancia de un asignador-moderador. Ver comentarios

[in] lpPresInfo

Especifica la estructura VMRPRESENTATIONINFO .

Valor devuelto

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

Comentarios

PresentImage se puede llamar cuando el filtro está en un estado en ejecución o en pausa. Solo se puede llamar a StartPresenting y StopPresenting en estado de ejecución. Por lo tanto, si el gráfico está en pausa antes de que se ejecute, PresentImage se llamará a antes de StartPresenting.

Las aplicaciones pueden crear efectos de combinación personalizados mediante una sola instancia de un Allocator-Presenter con varias instancias de VMR, ya sea en un único gráfico de filtro o en varios gráficos de filtros. El uso del moderador del asignador de esta manera permite a las aplicaciones combinar secuencias de distintos gráficos de filtro o combinar secuencias diferentes dentro del mismo gráfico de filtro. Si usa una única instancia de VMR, establezca este valor en cero.

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 (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IVMRImagePresenter (Interfaz)

Uso del representador de mezcla de vídeos