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 |