Método IVMRImagePresenter::P resentImage (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O PresentImage método é chamado precisamente no momento em que esse quadro de vídeo deve ser apresentado.
Sintaxe
HRESULT PresentImage(
[in] DWORD_PTR dwUserID,
[in] VMRPRESENTATIONINFO *lpPresInfo
);
Parâmetros
[in] dwUserID
Um DWORD_PTR definido pelo aplicativo que identifica exclusivamente essa instância da VMR em cenários em que várias instâncias da VMR estão sendo usadas com uma única instância de um Allocator-Presenter. Confira Comentários
[in] lpPresInfo
Especifica a estrutura VMRPRESENTATIONINFO .
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
PresentImage pode ser chamado quando o filtro está em um estado em execução ou em pausa. StartPresenting e StopPresenting só podem ser chamados em um estado em execução. Portanto, se o grafo for pausado antes de ser executado, PresentImage será chamado antes de StartPresenting.
Os aplicativos podem criar efeitos de combinação personalizados usando uma única instância de um Allocator-Presenter com várias instâncias da VMR em um único grafo de filtro ou em vários grafos de filtro. O uso do apresentador alocador dessa forma permite que os aplicativos mesclam fluxos de diferentes grafos de filtro ou mesclam fluxos diferentes no mesmo grafo de filtro. Se você estiver usando uma única instância da VMR, defina esse valor como zero.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |