Classe CBaseControlVideo

[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.]

A classe CBaseControlVideo implementa a interface IBasicVideo e controla as propriedades de vídeo de uma janela de vídeo genérica. Geralmente, um objeto CBaseControlVideo é um renderizador de vídeo que desenha vídeo em uma janela na tela.

Muitas funções membro CBaseControlVideo exigem apenas que o renderizador de vídeo seja conectado a um grafo de filtro. Se não estiver conectado, as funções membro retornarão VFW_E_NOT_CONNECTED. As propriedades definidas em um renderizador de vídeo persistem entre conexões sucessivas e desconexões. Todos os aplicativos devem garantir que eles redefinam as propriedades do renderizador antes de iniciar uma apresentação.

Ao trabalhar com vídeo, o aplicativo pode selecionar uma parte do vídeo a ser usada. Essa parte é o retângulo de origem que o objeto CBaseControlVideo controla. CBaseControlVideo permite que seu aplicativo defina e recupere o retângulo de origem. Todos os retângulos que CBaseControlVideo usa empregam valores de largura e altura em vez de valores de direita e inferior. Quando nenhum retângulo de origem tiver sido definido, as propriedades do retângulo de origem retornarão o tamanho completo do vídeo nativo.

Membros de Dados Protegidos	Descrição
m_pFilter	Ponteiro para um filtro de mídia proprietário.
m_pInterfaceLock	Seção crítica definida externamente.
m_pPin	Controle dos tipos de mídia para conexão.
Funções de membro	Descrição
Cbasecontrolvideo	Constrói um objeto CBaseControlVideo .
CopyImage	Cria uma cópia de memória de uma imagem de vídeo.
Getimagesize	Recupera informações de tamanho de imagem de vídeo.
SetControlVideoPin	Define o pino com o qual esse objeto deve ser sincronizado.
Funções membro substituíveis	Descrição
CheckSourceRect	Determina se um retângulo de origem é válido.
CheckTargetRect	Determina se um retângulo de destino é válido.
GetSourceRect	Recupera o retângulo de vídeo de origem atual (virtual puro).
GetStaticImage	Retorna a imagem atual em um buffer de memória (virtual puro).
GetTargetRect	Recupera o retângulo de vídeo de destino atual (virtual puro).
GetVideoFormat	Recupera a estrutura VIDEOINFOHEADER que contém o formato de vídeo.
IsDefaultSourceRect	Determina se o renderizador está usando o retângulo de origem padrão (virtual puro).
IsDefaultTargetRect	Determina se o renderizador está usando o retângulo de destino padrão (virtual puro).
OnUpdateRectangles	Chamado quando o retângulo de origem ou destino é alterado.
OnVideoSizeChange	Passa EC_VIDEO_SIZE_CHANGED para o aplicativo.
SetDefaultSourceRect	Define o retângulo de vídeo de origem padrão (virtual puro).
SetDefaultTargetRect	Define o retângulo de vídeo de destino padrão (virtual puro).
SetSourceRect	Define o retângulo de vídeo de origem atual (virtual puro).
SetTargetRect	Define o retângulo de destino atual (virtual puro).
Métodos IBasicVideo	Descrição
get_AvgTimePerFrame	Recupera um tempo médio aproximado por quadro.
get_BitErrorRate	Recupera uma taxa de erro de bits aproximada.
get_BitRate	Recupera uma taxa de bits aproximada para o vídeo.
GetCurrentImage	Recupera uma renderização de memória da imagem atual.
get_DestinationHeight	Recupera a altura do retângulo de destino atual.
get_DestinationLeft	Recupera a coordenada esquerda do retângulo de destino atual.
GetDestinationPosition	Recupera a posição de destino atual.
get_DestinationTop	Recupera a coordenada superior do retângulo de destino atual.
get_DestinationWidth	Recupera a largura do retângulo de destino atual.
get_SourceHeight	Recupera a altura do retângulo de origem atual.
get_SourceLeft	Recupera a coordenada esquerda do retângulo de origem atual.
GetSourcePosition	Recupera a posição de origem atual.
get_SourceTop	Recupera a coordenada superior do retângulo de origem atual.
get_SourceWidth	Recupera a largura do retângulo de origem atual.
get_VideoHeight	Recupera a altura do vídeo nativo.
GetVideoPaletteEntries	Recupera um intervalo de entradas de paleta para o vídeo.
GetVideoSize	Recupera a largura e a altura do vídeo nativo.
get_VideoWidth	Recupera a largura do vídeo nativo.
IsUsingDefaultDestination	Determina se o renderizador está usando a janela de destino padrão.
IsUsingDefaultSource	Determina se o renderizador está usando a janela de origem padrão.
put_DestinationHeight	Define a altura do retângulo de destino.
put_DestinationLeft	Define a coordenada esquerda do retângulo de destino.
put_DestinationTop	Define a coordenada superior do retângulo de destino.
put_DestinationWidth	Define a largura do retângulo de destino.
put_SourceHeight	Define a altura do retângulo de origem.
put_SourceLeft	Define a coordenada esquerda do retângulo de origem.
put_SourceTop	Define a coordenada superior do retângulo de origem.
put_SourceWidth	Define a largura do retângulo de origem.
SetDefaultDestinationPosition	Define a posição de destino padrão novamente.
SetDefaultSourcePosition	Define a posição de origem padrão novamente.
SetDestinationPosition	Define a posição do retângulo de destino.
SetSourcePosition	Define a posição do retângulo de origem.

 

Confira também

DirectShow Base Classes