Método IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)

Copia o quadro de vídeo atual para uma superfície DXGI ou bitmap WIC.

Sintaxe

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parâmetros

[in] pDstSurf

Um ponteiro para a interface IUnknown da superfície de destino.

[in] pSrc

Um ponteiro para uma estrutura MFVideoNormalizedRect que especifica o retângulo de origem.

[in] pDst

Um ponteiro para uma estrutura RECT que especifica o retângulo de destino.

[in] pBorderClr

Um ponteiro para uma estrutura MFARGB que especifica a cor da borda.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

No modo de servidor de quadros, chame esse método para blit o quadro de vídeo para uma superfície DXGI ou WIC. O aplicativo pode chamar esse método a qualquer momento depois que o Mecanismo de Mídia carregar um recurso de vídeo. Normalmente, no entanto, o aplicativo chama IMFMediaEngine::OnVideoStreamTick primeiro para determinar se um novo quadro está disponível. Se OnVideoStreamTick retornar S_OK, o aplicativo chamará TransferVideoFrame.

O Mecanismo de Mídia dimensiona e em caixas de correio o vídeo para se ajustar ao retângulo de destino. Ele preenche a área da caixa de correio com a cor da borda.

Para conteúdo protegido, chame o método IMFMediaEngineProtectedContent::TransferVideoFrame em vez desse método.

Requisitos

Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	mfmediaengine.h

Confira também

IMFMediaEngine