次の方法で共有

IDirectDrawSurface7::BltFast メソッド (ddraw.h)

  • [アーティクル]

ソース カラー キーまたはコピー先のカラー キーを使用して、ソース コピービットまたは透明ビットレットを実行します。

構文

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

パラメーター

[in] unnamedParam1

変換先サーフェスでビット分割する x 座標。

[in] unnamedParam2

変換先サーフェス上でビット分割する y 座標。

[in] unnamedParam3

ビットレットのソースである DirectDrawSurface オブジェクトの IDirectDrawSurface7 インターフェイスへのポインター。

[in] unnamedParam4

ソースサーフェス上からビット化する四角形の左上と右下のポイントを定義する RECT 構造体へのポインター。

[in] unnamedParam5

転送の種類。 次の転送が定義されています。

DDBLTFAST_DESTCOLORKEY

変換先の色キーを使用する透明なビットレット。

DDBLTFAST_NOCOLORKEY

透過性のない通常のコピー ビット。

DDBLTFAST_SRCCOLORKEY

ソース カラー キーを使用する透過的なビットレット。

DDBLTFAST_WAIT

bitbltter がビジー状態の場合は、DDERR_WASSTILLDRAWING メッセージを延期し、bitblt を設定したり、別のエラーが発生したりするとすぐに を返します。

戻り値

メソッドが成功した場合、戻り値はDD_OK。

失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。

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

解説

BltFast は、ハードウェアでサポートされている場合、常に非同期 blit を試行します。

BltFast は、表示メモリサーフェスでのみ機能し、ビットビット操作を実行するときにクリップすることはできません。 クリップーがアタッチされたサーフェスでこのメソッドを使用すると、呼び出しは失敗し、メソッドは DDERR_UNSUPPORTEDを返します。

IDirectDrawSurface7::BltFast のソフトウェア実装は、IDirectDrawSurface7::Blt メソッドよりも 10% 高速です。 ただし、ディスプレイ ハードウェアを使用する場合、2 つの間に速度の違いはありません。

通常、 IDirectDrawSurface7::BltFast は、ビットブラッターがビジー状態でビットレットを設定できない場合、エラーで直ちにを返します。 ただし、bitblt を設定するか、別のエラーが発生するまでこのメソッドを返さない場合は、DDBLTFAST_WAIT フラグを使用できます。

要件

   
対象プラットフォーム Windows
ヘッダー ddraw.h
Library Ddraw.lib
[DLL] Ddraw.dll

関連項目

IDirectDrawSurface7