Platform SDK: DirectX |
DirectDrawSurface7.BltFast メソッドは、転送元カラー キーまたは転送先カラー キーを使って、転送元コピー ブリットまたは透過型ブリットを実行する。
object.BltFast( _ dx As Long, _ dy As Long, _ ddS As DirectDrawSurface7, _ srcRect As RECT, _ trans As CONST_DDBLTFASTFLAGS) As Long
失敗すれば、次のいずれかのエラー コードを返す。
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 フラグを使用する。
このメソッドはしばしばエラーを引き起こすので、エラー オブジェクトにエラーを設定する代わりに、エラー コードを返す。