Méthode IDirectDrawClipper ::GetClipList (ddraw.h)
Récupère une copie de la liste de clips associée à un objet DirectDrawClipper. Pour sélectionner un sous-ensemble de la liste de clip, vous pouvez passer un rectangle qui extrait la liste de clips.
Syntaxe
HRESULT GetClipList(
[in] LPRECT unnamedParam1,
[out] LPRGNDATA unnamedParam2,
[out] LPDWORD unnamedParam3
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure RECT que GetClipList utilise pour découper la liste de clips. Définissez ce paramètre sur NULL pour récupérer l’intégralité de la liste de clip.
[out] unnamedParam2
Pointeur vers une structure RGNDATA qui reçoit la copie résultante de la liste de clips. Si ce paramètre a la valeur NULL, GetClipList remplit la variable à lpdwSize avec le nombre d’octets nécessaires pour contenir l’intégralité de la liste de clip.
[out] unnamedParam3
Pointeur vers une variable qui reçoit la taille de la liste de clips résultante. Lors de la récupération de la liste de clip, ce paramètre correspond à la taille de la mémoire tampon dans lpClipList. Lorsque lpClipList a la valeur NULL, la variable de lpdwSize reçoit la taille requise de la mémoire tampon, en octets.
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_GENERIC
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCLIPLIST
- DDERR_REGIONTOOSMALL
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |