Método IVMRImageCompositor::CompositeImage (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 CompositeImage método compõe os quadros atuais disponíveis em cada fluxo de entrada.

Sintaxe

HRESULT CompositeImage(
  [in] IUnknown             *pD3DDevice,
  [in] LPDIRECTDRAWSURFACE7 pddsRenderTarget,
  [in] AM_MEDIA_TYPE        *pmtRenderTarget,
  [in] REFERENCE_TIME       rtStart,
  [in] REFERENCE_TIME       rtEnd,
  [in] DWORD                dwClrBkGnd,
  [in] VMRVIDEOSTREAMINFO   *pVideoStreamInfo,
  [in] UINT                 cStreams
);

Parâmetros

[in] pD3DDevice

Ponteiro para a interface IUnknown do dispositivo Direct3D. O compositor deve converter isso em um tipo LPDIRECT3DDEVICE7 .

[in] pddsRenderTarget

Especifica a superfície do DirectDraw na qual todos os desenhos devem ser executados.

[in] pmtRenderTarget

Especifica o tipo de mídia da superfície DirectDraw.

[in] rtStart

Especifica a hora de início.

[in] rtEnd

Especifica a hora de término.

[in] dwClrBkGnd

Especifica a cor do plano de fundo.

[in] pVideoStreamInfo

Ponteiro para uma matriz de objetos de informações de fluxo de vídeo.

[in] cStreams

Especifica o número de fluxos a serem misturados, que é igual ao tamanho da matriz pVideoStreamInfo.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

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

Confira também

Códigos de erro e êxito

IVMRImageCompositor Interface

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