Interface IBasicVideo (control.h)

[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 IBasicVideo interface define propriedades de vídeo, como os retângulos de origem e de destino. Os filtros do Renderizador de Vídeo e do Renderizador de Combinação de Vídeo implementam essa interface, mas a interface é exposta a aplicativos por meio do Gerenciador de Grafo de Filtro. Os aplicativos sempre devem recuperar essa interface do Gerenciador de Grafo de Filtro.

A IBasicVideo interface manipula os seguintes retângulos associados à imagem de vídeo:

• O retângulo de origem é a parte da imagem original que é exibida.
• O retângulo de destino é a parte da janela de vídeo que recebe o retângulo de origem.
• O retângulo de vídeo é a imagem de vídeo original.

Em outras palavras, o renderizador de vídeo corta a imagem para o retângulo de origem e, em seguida, alonga ou reduz a imagem cortada para o retângulo de destino. Todas as dimensões do retângulo são fornecidas em pixels.

As propriedades definidas no Renderizador de Vídeo persistem entre conexões sucessivas e desconexões.

Códigos de erro: se o filtro do renderizador de vídeo não estiver conectado a outro filtro, todos os métodos retornarão o código de erro VFW_E_NOT_CONNECTED. Para a implementação do Gerenciador de Grafo de Filtro, se o grafo não contiver um filtro de renderizador de vídeo, todos os métodos retornarão E_NOINTERFACE. Observe que o Gerenciador de Grafo de Filtro expõe a interface mesmo quando o grafo não contém um renderizador de vídeo, portanto, um aplicativo pode consultar a interface antes de compilar o grafo.

Herança

A interface IBasicVideo herda da interface IDispatch . IBasicVideo também tem estes tipos de membros:

Métodos

A interface IBasicVideo tem esses métodos.

IBasicVideo::get_AvgTimePerFrame O método get_AvgTimePerFrame recupera o tempo médio entre quadros sucessivos.
IBasicVideo::get_BitErrorRate O método get_BitErrorRate recupera a taxa de erro de bit aproximada do fluxo de vídeo.
IBasicVideo::get_BitRate O método get_BitRate recupera a taxa de bits aproximada do fluxo de vídeo.
IBasicVideo::get_DestinationHeight O método get_DestinationHeight recupera a altura do retângulo de destino.
IBasicVideo::get_DestinationLeft O método get_DestinationLeft recupera a coordenada x do retângulo de destino.
IBasicVideo::get_DestinationTop O método get_DestinationTop recupera a coordenada y do retângulo de destino.
IBasicVideo::get_DestinationWidth O método get_DestinationWidth recupera a largura do retângulo de destino.
IBasicVideo::get_SourceHeight O método get_SourceHeight recupera a altura do retângulo de origem.
IBasicVideo::get_SourceLeft O método get_SourceLeft recupera a coordenada x do retângulo de origem.
IBasicVideo::get_SourceTop O método get_SourceTop recupera a coordenada y do retângulo de origem.
IBasicVideo::get_SourceWidth O método get_SourceWidth recupera a largura do retângulo de origem.
IBasicVideo::get_VideoHeight O método get_VideoHeight recupera a altura nativa do vídeo.
IBasicVideo::get_VideoWidth O método get_VideoWidth recupera a largura nativa do vídeo.
IBasicVideo::GetCurrentImage O método GetCurrentImage recupera a imagem atual aguardando no renderizador.
IBasicVideo::GetDestinationPosition O método GetDestinationPosition recupera a posição do retângulo de destino.
IBasicVideo::GetSourcePosition O método GetSourcePosition recupera a posição do retângulo de origem.
IBasicVideo::GetVideoPaletteEntries O método GetVideoPaletteEntries recupera as cores da paleta do vídeo.
IBasicVideo::GetVideoSize O método GetVideoSize recupera as dimensões de vídeo nativas.
IBasicVideo::IsUsingDefaultDestination O método IsUsingDefaultDestination consulta se o renderizador está usando o retângulo de destino padrão.
IBasicVideo::IsUsingDefaultSource O método IsUsingDefaultSource consulta se o renderizador está usando o retângulo de origem padrão.
IBasicVideo::p ut_DestinationHeight O método put_DestinationHeight define a altura do retângulo de destino.
IBasicVideo::p ut_DestinationLeft O método put_DestinationLeft define a coordenada x do retângulo de destino.
IBasicVideo::p ut_DestinationTop O método put_DestinationTop define a coordenada y do retângulo de destino.
IBasicVideo::p ut_DestinationWidth O método put_DestinationWidth define a largura do retângulo de destino.
IBasicVideo::p ut_SourceHeight O método put_SourceHeight define a altura do retângulo de origem.
IBasicVideo::p ut_SourceLeft O método put_SourceLeft define a coordenada x do retângulo de origem.
IBasicVideo::p ut_SourceTop O método put_SourceTop define a coordenada y do retângulo de origem.
IBasicVideo::p ut_SourceWidth O método put_SourceWidth define a largura do retângulo de origem.
IBasicVideo::SetDefaultDestinationPosition O método SetDefaultDestinationPosition é revertido para o retângulo de destino padrão. Depois que esse método é chamado, o renderizador de vídeo usa toda a janela para reprodução.
IBasicVideo::SetDefaultSourcePosition O método SetDefaultSourcePosition é revertido para o retângulo de origem padrão. Depois que esse método é chamado, o renderizador de vídeo usa toda a imagem de vídeo, sem cortar.
IBasicVideo::SetDestinationPosition O método SetDestinationPosition define o retângulo de destino.
IBasicVideo::SetSourcePosition O método SetSourcePosition define o retângulo de origem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	control.h (inclua Dshow.h)

Confira também

IDispatch