Interface IDirectDraw7 (ddraw.h)

Os aplicativos usam os métodos da interface IDirectDraw7 para criar objetos DirectDraw e trabalhar com variáveis no nível do sistema. Esta seção é uma referência aos métodos da interface IDirectDraw7 .

Herança

A interface IDirectDraw7 herda da interface IUnknown . IDirectDraw7 também tem estes tipos de membros:

Métodos

A interface IDirectDraw7 tem esses métodos.

IDirectDraw7::Compact No momento, esse método não está implementado. (IDirectDraw7.Compact)
IDirectDraw7::CreateClipper Cria um objeto DirectDrawClipper.
IDirectDraw7::CreatePalette Cria um objeto DirectDrawPalette para este objeto DirectDraw.
IDirectDraw7::CreateSurface Cria um objeto DirectDrawSurface para este objeto DirectDraw.
IDirectDraw7::D uplicateSurface Duplica um objeto DirectDrawSurface.
IDirectDraw7::EnumDisplayModes Enumera todos os modos de exibição que o hardware expõe por meio do objeto DirectDraw e que são compatíveis com uma descrição de superfície fornecida.
IDirectDraw7::EnumSurfaces Enumera todas as superfícies existentes ou possíveis que atendem à descrição da superfície especificada.
IDirectDraw7::EvaluateMode Usado após uma chamada para IDirectDraw7::StartModeTest para passar ou falhar em cada modo que o teste apresenta e percorrer os modos até que o teste seja concluído.
IDirectDraw7::FlipToGDISurface Faz com que a superfície que o GDI grava na superfície primária.
IDirectDraw7::GetAvailableVidMem Recupera a quantidade total de memória de exibição disponível e a quantidade de memória de exibição atualmente livre para um determinado tipo de superfície.
IDirectDraw7::GetCaps Recupera os recursos do driver de dispositivo para o hardware e a HEL (camada de emulação de hardware).
IDirectDraw7::GetDeviceIdentifier Obtém informações sobre o driver do dispositivo. Esse método pode ser usado, com cuidado, para reconhecer instalações de hardware específicas para implementar soluções alternativas para um comportamento ruim de driver ou chipset.
IDirectDraw7::GetDisplayMode Recupera o modo de exibição atual.
IDirectDraw7::GetFourCCCodes Recupera os códigos de quatro caracteres (FOURCC) compatíveis com o objeto DirectDraw. Esse método também pode recuperar o número de códigos com suporte.
IDirectDraw7::GetGDISurface Recupera o objeto DirectDrawSurface que atualmente representa a memória da superfície que a GDI está tratando como a superfície primária.
IDirectDraw7::GetMonitorFrequency Recupera a frequência do monitor que o objeto DirectDraw controla.
IDirectDraw7::GetScanLine Recupera a linha de verificação que está sendo desenhada no monitor no momento.
IDirectDraw7::GetSurfaceFromDC Recupera a interface IDirectDrawSurface7 para uma superfície, com base no identificador de contexto do dispositivo GDI.
IDirectDraw7::GetVerticalBlankStatus Recupera o status do espaço em branco vertical.
IDirectDraw7::Initialize Inicializa um objeto DirectDraw que foi criado usando a função COCreateInstance COM.
IDirectDraw7::RestoreAllSurfaces Restaura todas as superfícies que foram criadas para o objeto DirectDraw, na ordem em que foram criadas.
IDirectDraw7::RestoreDisplayMode Redefine o modo do hardware do dispositivo de exibição para a superfície primária para o que era antes do método IDirectDraw7::SetDisplayMode ser chamado. O acesso de nível exclusivo é necessário para usar esse método.
IDirectDraw7::SetCooperativeLevel Determina o comportamento de nível superior do aplicativo.
IDirectDraw7::SetDisplayMode Define o modo do hardware do dispositivo de exibição.
IDirectDraw7::StartModeTest Inicia um teste para atualizar o registro do sistema com informações de taxa de atualização para a combinação atual do adaptador de vídeo e do monitor.
IDirectDraw7::TestCooperativeLevel Relata o status de nível cooperativo atual do dispositivo DirectDraw para um aplicativo em janelas ou em tela inteira.
IDirectDraw7::WaitForVerticalBlank Ajuda o aplicativo a se sincronizar com o intervalo em branco vertical.

Comentários

Os métodos da interface IDirectDraw7 podem ser organizados nos seguintes grupos:

Grupo	Métodos
Alocando memória	Compactar e inicializar
Níveis cooperativos	SetCooperativeLevel e TestCooperativeLevel
Criando objetos	CreateClipper, CreatePalette e CreateSurface
Funcionalidades de dispositivo	Getcaps
Modos de exibição	EnumDisplayModes, GetDisplayMode, GetMonitorFrequency, RestoreDisplayMode, SetDisplayMode e WaitForVerticalBlank
Status de exibição	GetScanLine e GetVerticalBlankStatus
Diversos	EvaluateMode, GetAvailableVidMem, GetDeviceIdentifier, GetFourCCCodes e StartModeTest
Gerenciamento do Surface	DuplicateSurface, EnumSurfaces, FlipToGDISurface, GetGDISurface, GetSurfaceFromDC e RestoreAllSurfaces

 

A interface IDirectDraw7 estende os recursos das versões anteriores da interface oferecendo métodos que permitem um gerenciamento de superfície mais flexível do que as versões anteriores. Todos os métodos relacionados à superfície na interface IDirectDraw7 aceitam parâmetros ligeiramente diferentes de seus equivalentes na interface IDirectDraw2 . Onde quer que um método de interface IDirectDraw2 possa aceitar uma estrutura DDSURFACEDESC e recuperar uma interface IDirectDrawSurface3 , os métodos em IDirectDraw7 aceitam uma estrutura DDSURFACEDESC2 e recuperam uma interface IDirectDrawSurface7 .

O IDirectDraw7 apresenta uma conformidade aprimorada com as regras COM que determinam o tempo de vida dos objetos filho.

Use os tipos de dados LPDIRECTDRAW, LPDIRECTDRAW2, LPDIRECTDRAW4 ou LPDIRECTDRAW7 para declarar uma variável que contém um ponteiro para uma interface IDirectDraw, IDirectDraw2, IDirectDraw4 ou IDirectDraw7 . O arquivo de cabeçalho Ddraw.h declara esses tipos de dados com o seguinte código:

typedef struct IDirectDraw     FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2    FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4    FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7    FAR *LPDIRECTDRAW7;

Requisitos

Plataforma de Destino	Windows
Cabeçalho	ddraw.h