IDirectDrawSurface7：：BltFast 方法 (ddraw.h)

  • 發行項

使用來源色彩索引鍵或目的地色彩索引鍵，執行來源複製 bitblt 或透明 bitblt。

語法

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介面指標，該物件是 bitblt 的來源。

[in] unnamedParam4

RECT結構的指標，定義要從來源介面上位的矩形左上角和右下角點。

[in] unnamedParam5

傳輸的類型。 已定義下列傳輸：

DDBLTFAST_DESTCOLORKEY

使用目的地色彩索引鍵的透明 bitblt。

DDBLTFAST_NOCOLORKEY

沒有透明度的一般複製位。

DDBLTFAST_SRCCOLORKEY

使用來源色彩索引鍵的透明 bitblt。

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%。 不過，如果使用顯示器硬體，則兩者之間沒有速度差異。

通常，如果 bitbltter 忙碌且無法設定 bitblt， IDirectDrawSurface7：：BltFast 會立即傳回錯誤。 不過，如果您想要這個方法不要傳回，直到可以設定 bitblt 或發生另一個錯誤為止，您可以使用 DDBLTFAST_WAIT 旗標。

需求

   
目標平台 Windows
標頭 ddraw.h
程式庫 Ddraw.lib
Dll Ddraw.dll

另請參閱

IDirectDrawSurface7