Fonction DirectDrawCreateEx (ddraw.h)

Article
08/23/2023

Crée un instance d’un objet DirectDraw qui prend en charge l’ensemble d’interfaces Direct3D dans DirectX 7.0. Pour utiliser les fonctionnalités de Direct3D dans DirectX 7.0, créez un objet DirectDraw avec cette fonction.

Syntaxe

HRESULT DirectDrawCreateEx(
  [in]  GUID     *lpGuid,
  [out] LPVOID   *lplpDD,
  [in]  REFIID   iid,
  [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 IDirectDraw7 valide si l’appel réussit.

[in] iid

Ce paramètre doit être défini sur IID_IDirectDraw7. Cette fonction échoue et retourne DDERR_INVALIDPARAMS si une autre interface est spécifiée.

[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_DIRECTDRAWALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDDIRECTDRAWGUID
DDERR_INVALIDPARAMS
DDERR_NODIRECTDRAWHW
DDERR_OUTOFMEMORY

Notes

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 DirectDrawCreateEx .

Spécifications


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

Partager via