IDirectDrawSurface7::BltFast-Methode (ddraw.h)
Führt einen Quellkopiebitblt oder einen transparenten Bitblt mit einem Quellfarbschlüssel oder einem Zielfarbschlüssel aus.
Syntax
HRESULT BltFast(
[in] DWORD unnamedParam1,
[in] DWORD unnamedParam2,
[in] LPDIRECTDRAWSURFACE7 unnamedParam3,
[in] LPRECT unnamedParam4,
[in] DWORD unnamedParam5
);
Parameter
[in] unnamedParam1
Die x-Koordinate, in die bitblt auf der Zieloberfläche angezeigt werden soll.
[in] unnamedParam2
Die y-Koordinate, mit der auf der Zieloberfläche bitblt werden soll.
[in] unnamedParam3
Ein Zeiger auf die IDirectDrawSurface7-Schnittstelle für das DirectDrawSurface-Objekt, das die Quelle des Bitblts ist.
[in] unnamedParam4
Ein Zeiger auf eine RECT-Struktur , die die oberen linken und unteren rechten Punkte des Rechtecks definiert, von der aus auf der Quelloberfläche bitbltiert werden soll.
[in] unnamedParam5
Art der Übertragung. Die folgenden Übertragungen werden definiert:
DDBLTFAST_DESTCOLORKEY
Eine transparente Bitblt, die die Zielfarbtaste verwendet.
DDBLTFAST_NOCOLORKEY
Ein normaler Kopierbitblt ohne Transparenz.
DDBLTFAST_SRCCOLORKEY
Eine transparente Bitblt, die die Quellfarbtaste verwendet.
DDBLTFAST_WAIT
Verschiebt die DDERR_WASSTILLDRAWING Nachricht, wenn der Bitbltter ausgelastet ist, und gibt zurück, sobald die Bitblt eingerichtet werden kann oder ein anderer Fehler auftritt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_EXCEPTION
- DDERR_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDRECT
- DDERR_NOBLTHW
- DDERR_SURFACEBUSY
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_WASSTILLDRAWING
Hinweise
BltFast versucht immer einen asynchronen Blit, wenn er von der Hardware unterstützt wird.
BltFast funktioniert nur auf Anzeigespeicheroberflächen und kann nicht clipen, wenn es einen Bitblt-Vorgang ausführt. Wenn Sie diese Methode auf einer Oberfläche mit einem angefügten Clipper verwenden, schlägt der Aufruf fehl, und die Methode gibt DDERR_UNSUPPORTED zurück.
Die Softwareimplementierung von IDirectDrawSurface7::BltFast ist 10 Prozent schneller als die IDirectDrawSurface7::Blt-Methode . Es gibt jedoch keinen Geschwindigkeitsunterschied zwischen den beiden, wenn Anzeigehardware verwendet wird.
IDirectDrawSurface7::BltFast wird in der Regel sofort mit einem Fehler zurückgegeben, wenn der Bitbltter ausgelastet ist und die Bitblt nicht eingerichtet werden kann. Sie können jedoch das flag DDBLTFAST_WAIT verwenden, wenn diese Methode erst zurückgegeben werden soll, wenn entweder die Bitblt eingerichtet werden kann oder ein anderer Fehler auftritt.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |