Ler em inglês

Compartilhar via


Directdraw

Visão geral da tecnologia DirectDraw.

Para desenvolver o DirectDraw, você precisa desses cabeçalhos:

Para obter diretrizes de programação para essa tecnologia, consulte:

Funções

 
AddAttachedSurface

Anexa a superfície de buffer z especificada a essa superfície.
AddOverlayDirtyRect

O método IDirectDrawSurface7::AddOverlayDirtyRect não está implementado no momento.
Blt

Executa uma transferência de bloco de bits (bitblt). Esse método não dá suporte ao buffer z ou à mesclagem alfa durante operações bitblt.
BltBatch

O método IDirectDrawSurface7::BltBatch não está implementado no momento.
BltFast

Executa um bitblt de cópia de origem ou bitblt transparente usando uma chave de cor de origem ou uma chave de cor de destino.
ChangeUniquenessValue

Atualiza manualmente o valor de exclusividade dessa superfície.
Compacto

No momento, esse método não está implementado. (IDirectDraw7.Compact)
CreateClipper

Cria um objeto DirectDrawClipper.
Createpalette

Cria um objeto DirectDrawPalette para este objeto DirectDraw.
Createsurface

Cria um objeto DirectDrawSurface para este objeto DirectDraw.
DeleteAttachedSurface

Desanexa uma ou mais superfícies anexadas.
DirectDrawCreate

Cria uma instância de um objeto DirectDraw.
DirectDrawCreateClipper

Cria uma instância de um objeto DirectDrawClipper que não está associado a um objeto DirectDraw.
DirectDrawCreateEx

Cria uma instância de um objeto DirectDraw que dá suporte ao conjunto de interfaces Direct3D no DirectX 7.0. Para usar os recursos do Direct3D no DirectX 7.0, crie um objeto DirectDraw com essa função.
DirectDrawEnumerateA

Essa função é substituída pela função DirectDrawEnumerateEx. (ANSI)
DirectDrawEnumerateExA

Enumera todos os dispositivos DirectDraw instalados no computador. A entrada NULL sempre identifica o dispositivo de exibição primário que é compartilhado com GDI. (ANSI)
DirectDrawEnumerateExW

Enumera todos os dispositivos DirectDraw instalados no computador. A entrada NULL sempre identifica o dispositivo de exibição primário que é compartilhado com GDI. (Unicode)
DirectDrawEnumerateW

Essa função é substituída pela função DirectDrawEnumerateEx. (Unicode)
DuplicateSurface

Duplica um objeto DirectDrawSurface.
EnumAttachedSurfaces

Enumera todas as superfícies anexadas a essa superfície.
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.
EnumOverlayZOrders

Enumera as superfícies de sobreposição no destino especificado. Você pode enumerar as sobreposições na ordem front-to-back ou back-to-front.
EnumSurfaces

Enumera todas as superfícies existentes ou possíveis que atendem à descrição da superfície especificada.
EvaluateMode

Usado após uma chamada para IDirectDraw7::StartModeTest para passar ou falhar em cada modo que o teste apresenta e para percorrer os modos até que o teste seja concluído.
Inverter

Faz com que a memória da superfície associada ao DDSCAPS_BACKBUFFER superfície se associe à superfície do buffer frontal.
FlipToGDISurface

Torna a superfície que o GDI grava na superfície primária.
FreePrivateData

Libera os dados privados especificados associados a essa superfície.
GetAttachedSurface

Obtém a superfície anexada que tem os recursos especificados e incrementa a contagem de referência da interface recuperada.
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.
GetBltStatus

Obtém status sobre uma operação de transferência de bloco de bits (bitblt).
Getcaps

Recupera os recursos do driver de dispositivo para o hardware e a HEL (camada de emulação de hardware).
Getcaps

Recupera os recursos do objeto de paleta.
Getcaps

Recupera os recursos dessa superfície. Esses recursos não estão necessariamente relacionados aos recursos do dispositivo de exibição.
GetClipList

Recupera uma cópia da lista de clipes associada a um objeto DirectDrawClipper. Para selecionar um subconjunto da lista de clipes, você pode passar um retângulo que corta a lista de clipes.
GetClipper

Recupera o objeto DirectDrawClipper associado a essa superfície e incrementa a contagem de referência do cortador retornado.
GetColorControls

Recupera as configurações atuais de controle de cores associadas a uma sobreposição ou uma superfície primária.
GetColorKey

Recupera o valor da chave de cor para essa superfície.
Getdc

Cria um identificador compatível com GDI de um contexto de dispositivo para essa superfície.
GetDDInterface

Recupera uma interface para o objeto DirectDraw que foi usado para criar essa superfície.
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 comportamentos ruins de driver ou chipset.
GetDisplayMode

Recupera o modo de exibição atual.
Getentries

Recupera valores de paleta de um objeto DirectDrawPalette.
GetFlipStatus

Recupera status sobre se essa superfície terminou seu processo de inversão.
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.
GetGammaRamp

Recupera as rampas gama vermelhas, verdes e azuis para a superfície primária.
GetGDISurface

Recupera o objeto DirectDrawSurface que atualmente representa a memória de superfície que a GDI está tratando como a superfície primária.
GetHWnd

Recupera o identificador de janela que foi anteriormente associado a esse objeto DirectDrawClipper pelo método IDirectDrawClipper::SetHWnd.
GetLOD

Recupera o lod (nível máximo de detalhes) atualmente definido para uma superfície mipmap gerenciada. Esse método só tem êxito em texturas gerenciadas.
GetMonitorFrequency

Recupera a frequência do monitor que o objeto DirectDraw controla.
GetOverlayPosition

Recupera as coordenadas de exibição dessa superfície. Esse método é usado em uma superfície de sobreposição visível e ativa (ou seja, uma superfície que tem o sinalizador DDSCAPS_OVERLAY definido).
GetPalette

Recupera o objeto DirectDrawPalette associado a essa superfície e incrementa a contagem de referência da paleta retornada.
GetPixelFormat

Recupera a cor e o formato de pixel dessa superfície.
Getpriority

Recupera a prioridade de gerenciamento de textura para essa textura. Esse método só tem êxito em texturas gerenciadas.
GetPrivateData

Copia os dados privados associados a essa superfície para um buffer fornecido.
GetScanLine

Recupera a linha de verificação que está sendo desenhada no monitor no momento.
GetSurfaceDesc

Recupera uma descrição dessa superfície em sua condição atual.
GetSurfaceFromDC

Recupera a interface IDirectDrawSurface7 para uma superfície, com base no identificador de contexto do dispositivo GDI.
GetUniquenessValue

Recupera o valor de exclusividade atual para essa superfície.
GetVerticalBlankStatus

Recupera o status do espaço em branco vertical.
Initialize

Inicializa um objeto DirectDraw que foi criado usando a função COCreateInstance COM.
Initialize

Inicializa um objeto DirectDrawClipper que foi criado usando a função COCreateInstance COM.
Initialize

Inicializa o objeto DirectDrawPalette.
Initialize

Inicializa um objeto DirectDrawSurface.
IsClipListChanged

Recupera o status da lista de clipes se um identificador de janela estiver associado a um objeto DirectDrawClipper.
IsLost

Determina se a memória de superfície associada a um objeto DirectDrawSurface foi liberada.
Bloquear

Obtém um ponteiro para a memória da superfície.
LPDDENUMCALLBACKA

A função DDEnumCallback é uma função de retorno de chamada definida pelo aplicativo para a função DirectDrawEnumerate. (ANSI)
LPDDENUMCALLBACKEXA

A função DDEnumCallbackEx é uma função de retorno de chamada definida pelo aplicativo para a função DirectDrawEnumerateEx. (ANSI)
LPDDENUMCALLBACKEXW

A função DDEnumCallbackEx é uma função de retorno de chamada definida pelo aplicativo para a função DirectDrawEnumerateEx. (Unicode)
LPDDENUMCALLBACKW

A função DDEnumCallback é uma função de retorno de chamada definida pelo aplicativo para a função DirectDrawEnumerate. (Unicode)
LPDDENUMMODESCALLBACK

Não use. Essa função de retorno de chamada é substituída pela função EnumModesCallback2 que é usada com o método IDirectDraw7::EnumDisplayModes.
LPDDENUMMODESCALLBACK2

A função EnumModesCallback2 é uma função de retorno de chamada definida pelo aplicativo para o método IDirectDraw7::EnumDisplayModes.
LPDDENUMSURFACESCALLBACK

A função LPDDENUMSURFACESCALLBACK (ddraw.h) é substituída pela função EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK2

A função LPDDENUMSURFACESCALLBACK2 (ddraw.h) é substituída pela função EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK7

A função EnumSurfacesCallback7 é uma função de retorno de chamada definida pelo aplicativo para os métodos IDirectDrawSurface7::EnumAttachedSurfaces e IDirectDrawSurface7::EnumOverlayZOrders.
PageLock

Impede que uma superfície de memória do sistema seja paginada enquanto uma operação de transferência de bits (bitblt) que usa transferências de DMA (acesso direto à memória) de ou para a memória do sistema está em andamento.
PageUnlock

Desbloqueia uma superfície de memória do sistema, que permite que ela seja paginada.
Releasedc

Libera o identificador de um contexto de dispositivo que foi obtido anteriormente usando o método IDirectDrawSurface7::GetDC.
Restaurar

Restaura uma superfície que foi perdida. Isso ocorre quando a memória de superfície associada ao objeto DirectDrawSurface foi liberada.
RestoreAllSurfaces

Restaura todas as superfícies que foram criadas para o objeto DirectDraw, na ordem em que foram criadas.
RestoreDisplayMode

Redefine o modo do hardware do dispositivo de exibição da 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.
SetClipList

Define ou exclui a lista de clipes usada pelos métodos IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay em superfícies às quais o objeto DirectDrawClipper pai está anexado.
SetClipper

Anexa um objeto clipper a ou exclui um dessa superfície.
SetColorControls

Define as opções de controle de cor para uma sobreposição ou uma superfície primária.
Setcolorkey

Define o valor da chave de cor para o objeto DirectDrawSurface se o hardware der suporte a chaves de cor por superfície.
Setcooperativelevel

Determina o comportamento de nível superior do aplicativo.
Setdisplaymode

Define o modo do hardware do dispositivo de exibição.
SetEntries

Altera as entradas em um objeto DirectDrawPalette imediatamente.
SetGammaRamp

Define as rampas gama vermelhas, verdes e azuis para a superfície primária.
Sethwnd

Define o identificador de janela que o objeto clipper usa para obter informações de recorte.
SetLOD

Define o lod (nível máximo de detalhes) para uma superfície mipmap gerenciada. Esse método só tem êxito em texturas gerenciadas.
SetOverlayPosition

Altera as coordenadas de exibição de uma superfície de sobreposição.
Setpalette

Anexa um objeto de paleta a (ou desanexa um de) uma superfície. A superfície usa essa paleta para todas as operações subsequentes. A alteração da paleta ocorre imediatamente, sem considerar o tempo de atualização.
Setpriority

Atribui a prioridade de gerenciamento de textura para essa textura. Esse método só tem êxito em texturas gerenciadas.
SetPrivateData

Associa dados à superfície que se destina a ser usada pelo aplicativo, não pelo DirectDraw. Os dados são passados por valor e vários conjuntos de dados podem ser associados a uma única superfície.
SetSurfaceDesc

Define as características de uma superfície existente.
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 exibição e do monitor.
Testcooperativelevel

Relata o status de nível cooperativo atual do dispositivo DirectDraw para um aplicativo em janelas ou de tela inteira.
Unlock

Notifica o DirectDraw de que as manipulações diretas de superfície estão concluídas.
Updateoverlay

Reposiciona ou modifica os atributos visuais de uma superfície de sobreposição. Essas superfícies devem ter o sinalizador DDSCAPS_OVERLAY definido.
UpdateOverlayDisplay

O método IDirectDrawSurface7::UpdateOverlayDisplay não está implementado no momento.
UpdateOverlayZOrder

Define a ordem z de uma sobreposição.
WaitForVerticalBlank

Ajuda o aplicativo a se sincronizar com o intervalo em branco vertical.

Interfaces

 
IDirectDraw7

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

Os aplicativos usam os métodos da interface IDirectDrawClipper para gerenciar listas de clipes. Esta seção é uma referência aos métodos dessa interface.
Idirectdrawcolorcontrol

Os aplicativos usam os métodos da interface IDirectDrawColorControl para obter e definir controles de cor.
IDirectDrawGammaControl

Os aplicativos usam os métodos da interface IDirectDrawGammaControl para ajustar os níveis de rampa gama vermelha, verde e azul da superfície primária. Esta seção é uma referência aos métodos dessa interface.
IDirectDrawPalette

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

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

Estruturas

 
DDCOLORCONTROL

A estrutura DDCOLORCONTROL define os controles de cor associados a um objeto VPE (extensões de porta de vídeo) do Microsoft DirectDraw.
DDSURFACEDESC

A estrutura DDSURFACEDESC contém uma descrição de uma superfície a ser criada pelo driver.
DDSURFACEDESC2

A estrutura DDSURFACEDESC2 contém uma descrição de uma superfície a ser criada pelo driver.
DDBLTBATCH

A estrutura DDBLTBATCH passa operações de bit block transfer (bitblt) para o método IDirectDrawSurface7::BltBatch.
DDBLTFX

A estrutura DDBLTFX passa rops (operações de raster), efeitos e informações de substituição para o método IDirectDrawSurface7::Blt. Essa estrutura também faz parte da estrutura DDBLTBATCH usada com o método IDirectDrawSurface7::BltBatch.
DDCAPS_DX3

A estrutura DDCAPS_DX3 (ddraw.h) representa os recursos do hardware exposto por meio do objeto DirectDraw.
DDCAPS_DX5

A estrutura de DDCAPS_DX5 (ddraw.h) representa os recursos do hardware exposto por meio do objeto DirectDraw.
DDCAPS_DX6

A estrutura DDCAPS_DX6 (ddraw.h) representa os recursos do hardware exposto por meio do objeto DirectDraw.
DDCAPS_DX7

A estrutura de DDCAPS_DX7 (ddraw.h) representa os recursos do hardware exposto por meio do objeto DirectDraw.
DDCOLORKEY

A estrutura DDCOLORKEY descreve uma chave de cor de origem, uma chave de cor de destino ou um espaço de cor.
DDDEVICEIDENTIFIER2

A estrutura DDDEVICEIDENTIFIER2 é passada para o método IDirectDraw7::GetDeviceIdentifier para obter informações sobre um dispositivo.
DDGAMMARAMP

A estrutura DDGAMMARAMP contém dados de rampa vermelho, verde e azul para os métodos IDirectDrawGammaControl::GetGammaRamp e IDirectDrawGammaControl::SetGammaRamp.
DDOVERLAYFX

A estrutura DDOVERLAYFX passa informações de sobreposição para o método IDirectDrawSurface7::UpdateOverlay.
DDPIXELFORMAT

A estrutura DDPIXELFORMAT descreve o formato de pixel de um objeto DirectDrawSurface para o método IDirectDrawSurface7::GetPixelFormat.
DDSCAPS

A estrutura DDSCAPS define os recursos de um objeto de superfície do Microsoft DirectDraw.
DDSCAPS2

A estrutura DDSCAPS2 define recursos adicionais de um objeto de superfície do Microsoft DirectDraw.