Fonction D3DX10CreateDevice

Article
06/13/2023

Créez le meilleur appareil Direct3D 10 qui représente l’adaptateur d’affichage. Si un appareil compatible Direct3D 10.1 peut être créé, il sera possible d’acquérir un pointeur d’interface ID3D10Device1 à partir du pointeur d’interface de l’appareil retourné.

Syntaxe

HRESULT D3DX10CreateDevice(
  _In_  IDXGIAdapter      *pAdapter,
  _In_  D3D10_DRIVER_TYPE DriverType,
  _In_  HMODULE           Software,
  _In_  UINT              Flags,
  _Out_ ID3D10Device      **ppDevice
);

Paramètres

pAdapter [in]

Type : IDXGIAdapter*

Pointeur vers l’adaptateur d’affichage (voir l’interface 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 l’interface IDXGIFactory .

DriverType [in]

Type : D3D10_DRIVER_TYPE

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

Logiciel [dans]

Type : HMODULE

Handle vers un module chargé qui implémente un pilote logiciel (tel que D3D10Ref.dll). Pour obtenir un handle, appelez la fonction GetModuleHandle .

Indicateurs [in]

Type : UINT

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

ppDevice [out]

Type : ID3D10Device**

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

Valeur retournée

Type : HRESULT

Cette fonction retourne l’un des codes de retour Direct3D 10 suivants.

Notes

Cette fonction tente de créer le meilleur appareil pour le matériel. Tout d’abord, la fonction tente de créer un appareil 10.1. Si un appareil 10.1 ne peut pas être créé, la fonction tente de créer un appareil 10.0. Si aucun appareil n’est créé, la fonction retourne E_FAIL.

Si votre application doit créer uniquement un appareil 10.1 ou un appareil 10.0 uniquement, utilisez plutôt les fonctions suivantes :

Utilisez la fonction D3D10CreateDevice pour créer un appareil Direct3D 10.0 uniquement.
Utilisez la fonction D3D10CreateDevice1 pour créer un appareil Direct3D 10.1 uniquement.
Utilisez la fonction D3DX10GetFeatureLevel1 pour obtenir un pointeur d’interface ID3D10Device1 à partir d’un pointeur d’interface ID3D10Device .

Un appareil Direct3D 10.1 ne peut être créé que sur des ordinateurs exécutant Windows Vista Service Pack 1 ou version ultérieure, et avec du matériel compatible direct3D 10.1 installé. Toutefois, il est légal d’appeler cette fonction sur les ordinateurs exécutant n’importe quelle version de Windows sur lesquels la DLL D3DX10 est installée.

Spécifications

Condition requise	Valeur
En-tête	D3DX10Core.h

Voir aussi

fonctions usage général