Compartilhar via


Método CDrawImage.DrawImage

[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 DrawImage método desenha um quadro de vídeo na janela de vídeo.

Sintaxe

BOOL DrawImage(
   IMediaSample *pMediaSample
);

Parâmetros

pMediaSample

Ponteiro para a interface IMediaSample do exemplo que contém a imagem.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário.

Comentários

Esse método delega para CDrawImage::FastRender ou CDrawImage::SlowRender, dependendo se o filtro possui o alocador que forneceu o exemplo. Se o filtro for o proprietário do alocador, será garantido que o exemplo seja um objeto CImageSample . Nesse caso, o exemplo usa memória compartilhada alocada por GDI e a imagem pode ser desenhada usando BitBlt ou StretchBlt. Caso contrário, as imagens devem ser desenhadas usando as funções SetDIBitsToDevice ou StretchDIBits mais lentas.

Em builds de depuração, esse método chama DisplaySampleTimes para desenhar os carimbos de data/hora da amostra sobre a imagem de vídeo.

Requisitos

Requisito Valor
parâmetro
Winutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CDrawImage

CDrawImage::UsingImageAllocator