Platform SDK: DirectX

DirectDrawSurface7.BltFast

DirectDrawSurface7.BltFast メソッドは、転送元カラー キーまたは転送先カラー キーを使って、転送元コピー ブリットまたは透過型ブリットを実行する。

object.BltFast( _ 
    dx As Long, _ 
    dy As Long, _ 
    ddS As DirectDrawSurface7, _ 
    srcRect As RECT, _ 
    trans As CONST_DDBLTFASTFLAGS) As Long

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
dxdy
転送先サーフェス上にブリットする x 座標と y 座標。
ddS
ブリットの転送元である DirectDrawSurface オブジェクトに対する DirectDrawSurface7 オブジェクト。
srcRect
転送元サーフェス上からブリットする矩形の左上と右下の位置を定義する RECT 型。
trans
転送のタイプを識別する CONST_DDBLTFASTFLAGS 列挙の定数の 1 つ。

エラー コード

失敗すれば、次のいずれかのエラー コードを返す。

DDERR_EXCEPTION
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOBLTHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

注意

ハードウェアが非同期ブリットをサポートする場合、このメソッドは常にそれを試みる。

このメソッドはディスプレイ メモリ サーフェス上だけで作用し、ブリット中はクリップできない。アタッチしたクリッパーのあるサーフェス上でこのメソッドを使用する場合、呼び出しは失敗して、メソッドは DDERR_UNSUPPORTED を返す。

DirectDrawSurface7.BltFast のソフトウェア実装は、DirectDrawSurface7.Blt メソッドよりも 10 パーセント高速となる。ただし、ディスプレイ ハードウェアを使用している場合は、速さの違いはない。

通常、ブリットがビジーの場合、およびブリットがセット アップされていない場合、DirectDrawSurface7.BltFast は即座にエラーを返す。ただし、ブリットがセット アップされるか別のエラーが発生するまで、このメソッドを返さない場合は、DDBLTFAST_WAIT フラグを使用する。

このメソッドはしばしばエラーを引き起こすので、エラー オブジェクトにエラーを設定する代わりに、エラー コードを返す。