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 |