D3D10CreateDevice, fonction (d3d10misc.h)

Article
02/26/2024

Créez un appareil Direct3D 10.0 qui représente l’adaptateur d’affichage.

Syntaxe

HRESULT D3D10CreateDevice(
  [in]  IDXGIAdapter      *pAdapter,
  [in]  D3D10_DRIVER_TYPE DriverType,
  [in]  HMODULE           Software,
  [in]  UINT              Flags,
  [in]  UINT              SDKVersion,
  [out] ID3D10Device      **ppDevice
);

Paramètres

[in] pAdapter

Type : IDXGIAdapter*

Pointeur vers l’adaptateur d’affichage (consultez IDXGIAdapter) lors de la création d’un périphérique matériel ; sinon, définissez ce paramètre sur NULL. Si null est spécifié lors de la création d’un périphérique matériel, Direct3D utilise le premier adaptateur énuméré par EnumAdapters.

[in] DriverType

Type : D3D10_DRIVER_TYPE

Type de pilote de périphérique (voir D3D10_DRIVER_TYPE). Le type de pilote détermine le type d’appareil que vous allez créer.

[in] Software

Type : HMODULE

Réservé. Défini sur NULL.

[in] Flags

Type : UINT

facultatif. Indicateurs de création d’appareils (voir D3D10_CREATE_DEVICE_FLAG) qui activent les couches d’API. Ces indicateurs peuvent être or au niveau du bit.

[in] SDKVersion

Type : UINT

Indicateur de bits qui indique la version du Kit de développement logiciel (SDK). Doit toujours être D3D10_SDK_VERSION.

[out] ppDevice

Type : ID3D10Device**

Adresse d’un pointeur vers l’appareil créé (voir INTERFACE ID3D10Device).

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 10 suivants.

Remarques

Cet exemple crée un appareil de référence.


ID3D10Device* g_pd3dDevice = NULL;
D3D10CreateDevice( NULL, D3D10_DRIVER_TYPE_REFERENCE, NULL, 0, 
    D3D10_SDK_VERSION, &g_pd3dDevice );

Pour créer un appareil et une chaîne d’échange en même temps, consultez D3D10CreateDeviceAndSwapChain.

L’objet retourné par D3D10CreateDevice implémente l’interface IUnknown et peut être interrogé pour d’autres interfaces prises en charge par l’objet. Pour récupérer l’interface IDXGIDevice de l’objet, le code suivant peut être utilisé.


IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);

Configuration requise

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

Voir aussi

Fonctions Core

Partager via