IDirectDrawSurface7::BltFast, méthode (ddraw.h)

Article
08/23/2023

Effectue un bitblt de copie source ou un bitblt transparent à l’aide d’une clé de couleur source ou d’une clé de couleur de destination.

Syntaxe

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

Paramètres

[in] unnamedParam1

Coordonnée x vers laquelle effectuer le bitblt sur l’aire de destination.

[in] unnamedParam2

Coordonnée y sur laquelle effectuer le bitblt sur l’aire de destination.

[in] unnamedParam3

Pointeur vers l’interface IDirectDrawSurface7 pour l’objet DirectDrawSurface qui est la source du bitblt.

[in] unnamedParam4

Pointeur vers une structure RECT qui définit les points supérieurs gauche et inférieur droit du rectangle à partir de la surface source.

[in] unnamedParam5

Type de transfert. Les transferts suivants sont définis :

DDBLTFAST_DESTCOLORKEY

Bitblt transparent qui utilise la clé de couleur de destination.

DDBLTFAST_NOCOLORKEY

Un bitblt de copie normal sans transparence.

DDBLTFAST_SRCCOLORKEY

Un bitblt transparent qui utilise la clé de couleur source.

DDBLTFAST_WAIT

Reporte le message DDERR_WASSTILLDRAWING si le bitbltter est occupé et retourne dès que le bitblt peut être configuré ou qu’une autre erreur se produit.

Valeur retournée

Si la méthode réussit, la valeur de retour est DD_OK.

En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :

DDERR_EXCEPTION
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOBLTHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

Notes

BltFast tente toujours une fente asynchrone si elle est prise en charge par le matériel.

BltFast fonctionne uniquement sur les surfaces de mémoire d’affichage et ne peut pas cliper lorsqu’il effectue une opération bitblt. Si vous utilisez cette méthode sur une surface avec un clipper attaché, l’appel échoue et la méthode retourne DDERR_UNSUPPORTED.

L’implémentation logicielle de IDirectDrawSurface7::BltFast est 10 % plus rapide que la méthode IDirectDrawSurface7::Blt . Toutefois, il n’existe aucune différence de vitesse entre les deux si le matériel d’affichage est utilisé.

En règle générale, IDirectDrawSurface7::BltFast retourne immédiatement avec une erreur si le bitbltter est occupé et que le bitblt ne peut pas être configuré. Vous pouvez toutefois utiliser l’indicateur DDBLTFAST_WAIT si vous souhaitez que cette méthode ne retourne pas tant que le bitblt n’est pas configuré ou qu’une autre erreur ne se produit pas.

Spécifications


Plateforme cible	Windows
En-tête	ddraw.h
Bibliothèque	Ddraw.lib
DLL	Ddraw.dll

Voir aussi

IDirectDrawSurface7

Partager via