IOverlay Interface
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa interface fornece informações para um filtro pode gravar diretamente em vídeo memória enquanto colocando o vídeo na posição de janela correto.
Ele é implementado na entrada pino do vídeo processador e se comunica com um filtro upstream (geralmente um vídeo descompactador) por chamado do que filtro IOverlayNotify Métodos para notificação de alterações para o vídeo janela.
Essa interface não possui nenhum relacionamento para a funcionalidade sobreposição do DirectDraw.
O vídeo Microsoft processador desenha dados que recebe através de IMemInputPin interface, usando sobreposições DirectDraw quando disponível. Essa interface, usado no local de IMemInputPin, destina-se a fornecer suporte notificação para um filtro upstream que ignora recursos de desenho do processador, mas precisa notificações de outras propriedades exibir.
Veja a seção IOverlayNotify Para obter mais informações sobre como a interface IOverlay e IOverlayNotify trabalho interfaces juntos.
Quando a implementar
Essa interface é implementado em vídeo o DirectShow filtro processador.
Ele também pode ser implementado em vídeo de substituição filtros processador. Se fazer isso, implementar esta interface para que filtra escrever diretamente para a reserva quadro ou tentando posição uma sobreposição sabe por onde para exibir seu vídeo.
Para implementar essa interface, o processador deve estar preparado para usar métodos na IOverlayNotify interface do filtro fazendo o desenho, com as notificações de vídeo propriedade alterações.
O processador Window-Based no DirectShow oferece suporte tanto IMemInputPin e IOverlay Interfaces.
Essas duas interfaces são mutuamente exclusivos.
Um filtro decide usar o IOverlay interface transporte fornecendo um tipo de mídia durante conexão que tenha um subtipo de MEDIASUBTYPE_Overlay.
Após conexão, pode get e usar o IOverlay interface. Se ele se conecta com outro vídeo formatos (como MEDIASUBTYPE_RGB8), tentando chamar por meio IOverlay Retorna VFW_E_NOT_OVERLAY_CONNECTION.
Quando usar
Use os métodos sobre esta função de um filtro upstream que deve vídeo controle propriedades sobreposição e pretende identificador a exibição do vídeo dados próprio. Este geralmente é usada pelo vídeo hardware decodificadores que possuem um alternativo conexão para o vídeo hardware.
Métodos na ordem TabelaV
A seguinte tabela mostra os métodos que aparecem no TabelaV sob o padrão COM métodos herdadas IUnknown.
| Método | Descrição |
|---|---|
Recupera o atual paleta. |
|
Define a paleta. |
|
Recupera a chave cor usar como padrão. |
|
Retorna o identificador do atualmente ativo chave cor. |
|
Altera a chave cor. |
|
Retorna o identificador janela. |
|
Recupera a lista recorte. |
|
Recupera o atual vídeo retângulos origem e destino. |
|
Configura um link informar para os eventos sobreposição. |
|
Encerra o link Advise. |
Requisitos
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |