Método IDirectDrawSurface7::BltFast (ddraw.h)

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.

Sintaxe

HRESULT BltFast(
  [in] DWORD                unnamedParam1,
  [in] DWORD                unnamedParam2,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam3,
  [in] LPRECT               unnamedParam4,
  [in] DWORD                unnamedParam5
);

Parâmetros

[in] unnamedParam1

A coordenada x para bitblt para na superfície de destino.

[in] unnamedParam2

A coordenada y para bitblt para na superfície de destino.

[in] unnamedParam3

Um ponteiro para a interface IDirectDrawSurface7 para o objeto DirectDrawSurface que é a origem do bitblt.

[in] unnamedParam4

Um ponteiro para uma estrutura RECT que define os pontos superior esquerdo e inferior direito do retângulo para bitblt de na superfície de origem.

[in] unnamedParam5

Tipo de transferência. As seguintes transferências são definidas:

DDBLTFAST_DESTCOLORKEY

Um bitblt transparente que usa a chave de cor de destino.

DDBLTFAST_NOCOLORKEY

Um bitblt de cópia normal sem transparência.

DDBLTFAST_SRCCOLORKEY

Um bitblt transparente que usa a chave de cor de origem.

DDBLTFAST_WAIT

Adia a mensagem DDERR_WASSTILLDRAWING se o bitbltter estiver ocupado e retornar assim que o bitblt puder ser configurado ou ocorrer outro erro.

Valor retornado

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

• DDERR_EXCEPTION
• DDERR_GENERIC
• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_INVALIDRECT
• DDERR_NOBLTHW
• DDERR_SURFACEBUSY
• DDERR_SURFACELOST
• DDERR_UNSUPPORTED
• DDERR_WASSTILLDRAWING

Comentários

BltFast sempre tentará um blit assíncrono se for compatível com o hardware.

O BltFast funciona apenas em superfícies de memória de exibição e não pode ser recortar quando executa uma operação bitblt. Se você usar esse método em uma superfície com um cortador anexado, a chamada falhará e o método retornará DDERR_UNSUPPORTED.

A implementação de software de IDirectDrawSurface7::BltFast é 10% mais rápida que o método IDirectDrawSurface7::Blt . No entanto, não haverá diferença de velocidade entre os dois se o hardware de exibição for usado.

Normalmente, IDirectDrawSurface7::BltFast retorna imediatamente com um erro se o bitbltter estiver ocupado e o bitblt não puder ser configurado. Você pode usar o sinalizador DDBLTFAST_WAIT, no entanto, se quiser que esse método não retorne até que o bitblt possa ser configurado ou ocorra outro erro.

Requisitos

Confira também

IDirectDrawSurface7