Méthode IDirect3D9Ex::CreateDeviceEx (d3d9.h)

  • Article

Crée un appareil pour représenter l’adaptateur d’affichage.

Syntaxe

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

Paramètres

[in] Adapter

Type : UINT

Nombre ordinal qui désigne l’adaptateur d’affichage. D3DADAPTER_DEFAULT est toujours l’adaptateur d’affichage principal.

[in] DeviceType

Type : D3DDEVTYPE

Spécifie le type d’appareil. Consultez D3DDEVTYPE. Si le type d’appareil souhaité n’est pas disponible, la méthode échoue.

[in] hFocusWindow

Type : HWND

La fenêtre focus alerte Direct3D lorsqu’une application passe du mode de premier plan au mode arrière-plan. Pour le mode plein écran, la fenêtre spécifiée doit être une fenêtre de niveau supérieur. Pour le mode fenêtré, ce paramètre peut avoir la valeur NULL uniquement si le membre hDeviceWindow de pPresentationParameters est défini sur une valeur valide et non NULL .

[in] BehaviorFlags

Type : DWORD

Combinaison d’une ou plusieurs options (voir D3DCREATE) qui contrôlent la création d’appareils.

[in, out] pPresentationParameters

Type : D3DPRESENT_PARAMETERS*

Pointeur vers une structure D3DPRESENT_PARAMETERS , décrivant les paramètres de présentation de l’appareil à créer. Si BehaviorFlags spécifie D3DCREATE_ADAPTERGROUP_DEVICE, ce paramètre est un tableau. Quel que soit le nombre de têtes qui existent, une seule surface de profondeur/gabarit est automatiquement créée.

Ce paramètre est à la fois un paramètre d’entrée et un paramètre de sortie. L’appel de cette méthode peut changer plusieurs membres, notamment :

  • Si BackBufferCount, BackBufferWidth et BackBufferHeight ont la valeur 0 avant l’appel de la méthode, ils sont modifiés lorsque la méthode est retournée.
  • Si BackBufferFormat est égal à D3DFMT_UNKNOWN avant l’appel de la méthode, elle est modifiée lorsque la méthode est retournée.

[in, out] pFullscreenDisplayMode

Type : D3DDISPLAYMODEEX*

Mode d’affichage pour lorsque l’appareil est défini sur plein écran. Consultez D3DDISPLAYMODEEX. Si BehaviorFlags spécifie D3DCREATE_ADAPTERGROUP_DEVICE, ce paramètre est un tableau. Ce paramètre doit avoir la valeur NULL pour le mode fenêtré.

[out, retval] ppReturnedDeviceInterface

Type : IDirect3DDevice9Ex**

Adresse d’un pointeur vers le IDirect3DDevice9Ex retourné, qui représente l’appareil créé.

Valeur retournée

Type : HRESULT

Cette méthode retourne S_OK lorsque l’appareil de rendu ainsi que les mémoires tampons de la chaîne d’échange sont créés avec succès. D3DERR_DEVICELOST est retourné lorsqu’une erreur autre que l’entrée de l’appelant non valide est rencontrée.

Spécifications

   
Plateforme cible Windows
En-tête d3d9.h
Bibliothèque D3D9.lib

Voir aussi

IDirect3D9Ex