Direct3DCreate9, fonction (d3d9.h)

Créez un objet IDirect3D9 et retournez-y une interface.

Syntaxe

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

Paramètres

SDKVersion

Type : UINT

La valeur de ce paramètre doit être D3D_SDK_VERSION. Consultez la section Notes.

Valeur de retour

Type : IDirect3D9*

Si elle réussit, cette fonction retourne un pointeur vers une interface IDirect3D9 ; sinon, un pointeur NULL est retourné.

Remarques

L’objet Direct3D est le premier objet COM Direct3D que votre application graphique doit créer et le dernier objet que votre application doit libérer. Les fonctions d’énumération et de récupération des fonctionnalités d’un appareil sont accessibles via l’objet Direct3D. Cela permet aux applications de sélectionner des appareils sans les créer.

Créez un objet IDirect3D9 comme indiqué ici :

LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

L’interface IDirect3D9 prend en charge l’énumération des cartes graphiques actives et permet la création d’objets IDirect3DDevice9 . Si l’utilisateur ajoute dynamiquement des adaptateurs (soit en ajoutant des appareils au bureau, soit en stationnant un ordinateur portable à chaud), ces appareils ne seront pas inclus dans l’énumération. La création d’une interface IDirect3D9 expose les nouveaux appareils.

D3D_SDK_VERSION est passé à cette fonction pour s’assurer que les fichiers d’en-tête sur lesquels une application est compilée correspondent à la version des DLL du runtime installées sur l’ordinateur. D3D_SDK_VERSION est uniquement modifié dans le runtime lorsqu’une modification d’en-tête (ou une autre modification de code) nécessite la reconstruction d’une application. Si cette fonction échoue, elle indique que la version du fichier d’en-tête ne correspond pas à la version de la DLL du runtime.

Pour obtenir un exemple, consultez Création d’un appareil (Direct3D 9).

Configuration requise

Voir aussi

Fonctions Direct3D