Méthode IDirectDrawClipper::SetClipList (ddraw.h)
Définit ou supprime la liste de clips utilisée par les méthodes IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch et IDirectDrawSurface7::UpdateOverlay sur les surfaces auxquelles l’objet DirectDrawClipper parent est attaché.
Syntaxe
HRESULT SetClipList(
[in] LPRGNDATA unnamedParam1,
[in] DWORD unnamedParam2
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure RGNDATA valide pour la liste de clip à définir ou NULL. S’il existe une liste de clips associée à l’objet DirectDrawClipper et que cette valeur est NULL, la liste de clip est supprimée.
[in] unnamedParam2
Actuellement non utilisé et doit être défini sur 0.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_CLIPPERISUSINGHWND
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Notes
Vous ne pouvez pas définir la liste de clip si un handle de fenêtre est déjà associé à l’objet DirectDrawClipper.
La méthode IDirectDrawSurface7::BltFast ne peut pas être clipé. Si vous appelez IDirectDrawSurface7::BltFast sur une surface avec un clipper attaché, il retourne DDERR_UNSUPPORTED.
Spécifications
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |