CAggDrawSurface Class

9/8/2008

Essa classe agrega um interface IDirectDrawSurface.

Embora o DirectDraw interfaces (IDirectDraw e IDirectDrawSurface) pode ser potencialmente agregados, este recurso não ainda implementado.

Diversas partes do DirectShow requerem agregação das interfaces do DirectDraw. Em particular, o vídeo processador passa fora amostras de mídia que expõem IDirectDraw e IDirectDrawSurface. Esta classe e a classe CAggDirectDraw Class republicar os métodos da classe DirectDraw para que eles podem ser agregados.

Cada função de membro nessa classe, com a exceção do construtor, CAggDrawSurface::SetDirectDrawSurfacee CAggDrawSurface::NonDelegatingQueryInterface, simplesmente chama o correspondente método sobre a interface IDirectDrawSurface com os parâmetros passados para ele.

Membros de dados protegido

Membro	Descrição
m_pDirectDrawSurface	Superfície do DirectDraw.

Funções membro

Função membro	Descrição
CAggDrawSurface::CAggDrawSurface	Constrói um CAggDrawSurface WScript.Shell.
CAggDrawSurface::SetDirectDrawSurface	Define o objeto do DirectDraw para ser agregados por esta classe. Este valor deve ser chamado antes de IDirectDrawSurface interface métodos podem ser chamado.

Funções de associados overrideable

Função membro	Descrição
CAggDrawSurface::NonDelegatingQueryInterface	Recupera uma interface e incrementa o contagem de referência.

Métodos IDirectDrawSurface implementada

Método	Descrição
IDirectDrawSurface::AddOverlayDirtyRect	Não implementado.
IDirectDrawSurface::Blt	Executa um bit-transferir bloco.
IDirectDrawSurface::EnumAttachedSurfaces	Enumera todos as superfícies anexado para uma superfície determinada.
IDirectDrawSurface::EnumOverlayZOrders	Enumera as sobreposições de destino especificado. As sobreposições podem ser enumerado in front - para - voltar ou ordem Back-to-front.
IDirectDrawSurface::Flip	Torna a memória de superfície associado com a superfície DDSCAPS_BACKBUFFER se tornam associado com a superfície FRONTBUFFER.
IDirectDrawSurface::GetBltStatus	Recupera o status de transferir um bloco bit.
IDirectDrawSurface::GetCaps	Recupera as capacidades de superfície.
IDirectDrawSurface::GetClipper	Recupera o objeto DirectDrawClipper associado com essa superfície.
IDirectDrawSurface::GetColorKey	Recupera a chave cor valor para o objeto DirectDrawSurface.
IDirectDrawSurface::GetDC	Cria um GDI-compatível hDC para a superfície.
IDirectDrawSurface::GetFlipStatus	Retorna OK se a superfície que ele for chamado em concluiu o processo flipping; caso contrário, DDERR_WASSTILLDRAWING retorna.
IDirectDrawSurface::GetOverlayPosition	Recupera as coordenadas exibir da superfície, fornecida um visíveis, ativo superfície sobreposição (conjunto DDSCAPS_OVERLAY).
IDirectDrawSurface::GetPalette	Recupera a estrutura DirectDrawPalette associado com essa superfície.
IDirectDrawSurface::GetPixelFormat	Recupera a cor e formato do pixel da superfície.
IDirectDrawSurface::GetSurfaceDesc	Recupera uma estrutura DDSURFACEDESC descrevendo a superfície na sua atual condição.
IDirectDrawSurface::IsLost	Determina se a memória de superfície associado com um objeto DirectDrawSurface tiver sido liberado.
IDirectDrawSurface::Lock	Obtém um válido ponteiro para a memória de superfície.
IDirectDrawSurface::ReleaseDC	Libera um GDI-compatível hDC obtido anteriormente por meio CAggDrawSurface::GetDC.
IDirectDrawSurface::Restore	Restaura uma superfície que tenha sido "Perda". A memória de superfície associado com o objeto DirectDrawSurface tiver sido liberado.
IDirectDrawSurface::SetClipper	Anexa um objeto DirectDrawClipper a um objeto DirectDrawSurface.
IDirectDrawSurface::SetColorKey	Define a chave cor valor para o objeto DirectDrawSurface se o hardware oferecer suporte a chaves cor em uma base per-surface.
IDirectDrawSurface::SetOverlayPosition	Altera as coordenadas exibir de uma superfície sobreposição.
IDirectDrawSurface::SetPalette	Não suportado.
IDirectDrawSurface::Unlock	Notifica o DirectDraw que a direcionar são manipulações de superfície completo.
IDirectDrawSurface::UpdateOverlay	Reposiciona e / ou modifica os atributos visuais de uma superfície sobreposição. Esses superfícies devem ter o DDSCAPS_OVERLAY conjunto bit.
IDirectDrawSurface::UpdateOverlayZOrder	Define z de uma sobreposição-ordem. A z-ordem determina qual sobreposição deve ser occluded quando múltiplo sobreposições são exibidas simultaneamente.

Requisitos

Header	ddraw.h
Windows Embedded CE	Windows CE 2.12 and later
Windows Mobile	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