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 |