Méthode IDirectDraw7 ::CreateClipper (ddraw.h)
Crée un objet DirectDrawClipper.
Syntaxe
HRESULT CreateClipper(
[in] DWORD unnamedParam1,
[out] LPDIRECTDRAWCLIPPER *unnamedParam2,
[in] IUnknown *unnamedParam3
);
Paramètres
[in] unnamedParam1
Actuellement non utilisé et doit être défini sur 0.
[out] unnamedParam2
Adresse d’une variable à définir sur un pointeur d’interface IDirectDrawClipper valide si l’appel réussit.
[in] unnamedParam3
Permet une compatibilité future avec les fonctionnalités d’agrégation COM. Actuellement, cette méthode retourne une erreur si ce paramètre n’a pas la valeur NULL.
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_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
Remarques
L’objet DirectDrawClipper peut être attaché à un DirectDrawSurface et utilisé lors des opérations IDirectDrawSurface7 ::Blt, IDirectDrawSurface7 ::BltBatch et IDirectDrawSurface7 ::UpdateOverlay .
Pour créer un objet DirectDrawClipper qui n’appartient pas à un objet DirectDraw spécifique, utilisez la fonction DirectDrawCreateClipper .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |