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.
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) |