Metodo IDirectDrawClipper::SetClipList (ddraw.h)
Imposta o elimina l'elenco di clip utilizzato dai metodi IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay sulle superfici a cui è collegato l'oggetto DirectDrawClipper padre.
Sintassi
HRESULT SetClipList(
[in] LPRGNDATA unnamedParam1,
[in] DWORD unnamedParam2
);
Parametri
[in] unnamedParam1
Puntatore a una struttura RGNDATA valida per l'elenco di clip da impostare o NULL. Se è presente un elenco di clip esistente associato all'oggetto DirectDrawClipper e questo valore è NULL, l'elenco clip viene eliminato.
[in] unnamedParam2
Attualmente non usato e deve essere impostato su 0.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_CLIPPERISUSINGHWND
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Commenti
Non è possibile impostare l'elenco di clip se un handle di finestra è già associato all'oggetto DirectDrawClipper.
Impossibile ritagliare il metodo IDirectDrawSurface7::BltFast . Se si chiama IDirectDrawSurface7::BltFast su una superficie con un clipper collegato, restituisce DDERR_UNSUPPORTED.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |