Fonction DirectDrawCreate (ddraw.h)

Article
03/02/2024

Crée un instance d’un objet DirectDraw. Un objet DirectDraw créé à l’aide de cette fonction ne prend pas en charge l’ensemble complet d’interfaces Direct3D dans DirectX 7.0. Pour créer un objet DirectDraw capable d’exposer toutes les fonctionnalités de Direct3D dans DirectX 7.0, utilisez la fonction DirectDrawCreateEx .

Syntaxe

HRESULT DirectDrawCreate(
  [in]  GUID         *lpGUID,
  [out] LPDIRECTDRAW *lplpDD,
  [in]  IUnknown     *pUnkOuter
);

Paramètres

[in] lpGUID

Pointeur vers l’identificateur global unique (GUID) qui représente le pilote à créer. Cela peut être NULL pour indiquer le pilote d’affichage actif, ou vous pouvez passer l’un des indicateurs suivants pour restreindre le comportement du pilote d’affichage actif à des fins de débogage :

DDCREATE_EMULATIONONLY

L’objet DirectDraw utilise l’émulation pour toutes les fonctionnalités ; il ne tire pas parti des fonctionnalités prises en charge par le matériel.

DDCREATE_HARDWAREONLY

L’objet DirectDraw n’émule jamais les fonctionnalités non prises en charge par le matériel. Les tentatives d’appel de méthodes qui nécessitent des fonctionnalités non prises en charge échouent, ce qui renvoie DDERR_UNSUPPORTED.

[out] lplpDD

Pointeur vers une variable à définir sur un pointeur d’interface IDirectDraw valide si l’appel réussit.

[in] pUnkOuter

Permet une compatibilité future avec les fonctionnalités d’agrégation COM. Actuellement, toutefois, cette fonction retourne une erreur si ce paramètre est autre que 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_DIRECTDRAWALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDDIRECTDRAWGUID
DDERR_INVALIDPARAMS
DDERR_NODIRECTDRAWHW
DDERR_OUTOFMEMORY

Remarques

Cette fonction tente d’initialiser un objet DirectDraw, puis définit un pointeur vers l’objet si l’appel réussit.

Sur les ordinateurs avec plusieurs moniteurs, si vous spécifiez NULL pour lpGUID, l’objet DirectDraw s’exécute en mode émulation lorsque le niveau coopératif normal est défini. Pour utiliser l’accélération matérielle sur ces ordinateurs, spécifiez le GUID de l’appareil.

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

Configuration requise

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

Partager via