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