Platform SDK: DirectX

DirectDrawSurface7.BltFx

The DirectDrawSurface7.BltFx method performs a bit block transfer with additional blit effect behavior specified in the BltFx parameter.

object.BltFx( _ 
    destRect As RECT, _ 
    ddS As DirectDrawSurface7, _ 
    srcRect As RECT, _
    flags As CONST_DDBLTFLAGS, _ 
    BltFx As DDBLTFX) As Long

Parameters

object
Object expression that resolves to a DirectDrawSurface7 object.
destRect
RECT type that defines the upper-left and lower-right points of the rectangle to blit to on the destination surface. If this parameter is an empty RECT type, the entire destination surface is used.
ddS
DirectDrawSurface7 object that is the source for the blit.
srcRect
RECT type that defines the upper-left and lower-right points of the rectangle to blit from on the source surface. If this parameter is an empty RECT, the entire source surface is used.
flags
Combination of constants of the CONST_DDBLTFLAGS enumeration that determines the valid members of the associated DDBLTFX type, specifies color-key information, or requesta special behavior from the method.
BltFx
DDBLTFX type specifying additional blit effect operations to be performed.

Error Codes

If the method fails, it can return one of the following:

DDERR_GENERIC
DDERR_INVALIDCLIPLIST
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOALPHAHW
DDERR_NOBLTHW
DDERR_NOCLIPLIST
DDERR_NODDROPSHW
DDERR_NOMIRRORHW
DDERR_NORASTEROPHW
DDERR_NOROTATIONHW
DDERR_NOSTRETCHHW
DDERR_NOZBUFFERHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED

Remarks

Because this method often generates an error, instead of setting an error in the error object, the method returns the error code.