IDirectDrawClipper::SetClipList-Methode (ddraw.h)
Legt die Clipliste fest, die von den Methoden IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch und IDirectDrawSurface7::UpdateOverlay auf Oberflächen verwendet wird, an die das übergeordnete DirectDrawClipper-Objekt angefügt ist, oder löscht diese.
Syntax
HRESULT SetClipList(
[in] LPRGNDATA unnamedParam1,
[in] DWORD unnamedParam2
);
Parameter
[in] unnamedParam1
Ein Zeiger auf eine gültige RGNDATA-Struktur , für die die Clipliste festgelegt werden soll, oder NULL. Wenn eine Clipliste vorhanden ist, die dem DirectDrawClipper-Objekt zugeordnet ist und dieser Wert NULL ist, wird die Clipliste gelöscht.
[in] unnamedParam2
Derzeit nicht verwendet und muss auf 0 festgelegt werden.
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_CLIPPERISUSINGHWND
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Hinweise
Sie können die Clipliste nicht festlegen, wenn dem DirectDrawClipper-Objekt bereits ein Fensterhandle zugeordnet ist.
Die IDirectDrawSurface7::BltFast-Methode kann nicht clipen. Wenn Sie IDirectDrawSurface7::BltFast auf einer Oberfläche mit einem angefügten Clipper aufrufen, wird DDERR_UNSUPPORTED zurückgegeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |