Fonction DirectDrawCreateClipper (ddraw.h)

Article
02/28/2024

Crée une instance d’un objet DirectDrawClipper qui n’est pas associé à un objet DirectDraw.

Syntaxe

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

Paramètres

[in] dwFlags

Actuellement non utilisé et doit être défini sur 0.

[out] lplpDDClipper

Adresse d’un pointeur à remplir avec l’adresse du nouvel objet DirectDrawClipper.

[in] pUnkOuter

Permet une compatibilité future avec les fonctionnalités d’agrégation COM. Actuellement, cette fonction retourne une erreur si ce paramètre n’est pas NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est DD_OK.

En cas d’échec, la fonction peut retourner l’une des valeurs d’erreur suivantes :

DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

Remarques

Vous pouvez appeler DirectDrawCreateClipper avant de créer des objets DirectDraw. Étant donné que ces objets DirectDrawClipper ne appartiennent à aucun objet DirectDraw, ils ne sont pas automatiquement libérés lorsque les objets d’une application sont libérés. Si l’application ne libère pas explicitement les objets DirectDrawClipper, DirectDraw les libère à l’arrêt de l’application.

Pour créer un objet DirectDrawClipper appartenant à un objet DirectDraw spécifique, utilisez la méthode IDirectDraw7 ::CreateClipper .

Vous devez utiliser LoadLibrary pour établir un lien explicite vers Ddraw.dll, puis utiliser GetProcAddress pour accéder à la fonction DirectDrawCreateClipper .

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	ddraw.h
Bibliothèque	Ddraw.lib
DLL	Ddraw.dll

Partager via