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

Confira também

Códigos de erro e êxito

IVMRImagePresenter Interface

Usando o Renderizador de Combinação de Vídeo