Compartilhar via


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