Funzione D3DX10CreateDevice

Articolo
06/13/2023

Creare il dispositivo Direct3D 10 migliore che rappresenta la scheda di visualizzazione. Se è possibile creare un dispositivo compatibile con Direct3D 10.1, sarà possibile acquisire un puntatore all'interfaccia ID3D10Device1 dal puntatore all'interfaccia del dispositivo restituito.

Sintassi

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

Parametri

pAdapter [in]

Tipo: IDXGIAdapter*

Puntatore alla scheda di visualizzazione (vedere l'interfaccia IDXGIAdapter ) durante la creazione di un dispositivo hardware; in caso contrario, impostare questo parametro su NULL. Se si specifica NULL durante la creazione di un dispositivo hardware, Direct3D userà la prima scheda enumerata dall'interfaccia IDXGIFactory .

DriverType [in]

Tipo: D3D10_DRIVER_TYPE

Tipo di driver di dispositivo (vedere l'enumerazione D3D10_DRIVER_TYPE ). Il tipo di driver determina il tipo di dispositivo che verrà creato.

Software [in]

Tipo: HMODULE

Handle per un modulo caricato che implementa un driver software, ad esempio D3D10Ref.dll. Per ottenere un handle, chiamare la funzione GetModuleHandle .

Flag [in]

Tipo: UINT

Flag di creazione del dispositivo (vedere l'enumerazione D3D10_CREATE_DEVICE_FLAG ) che abilitano i livelli API. Questi flag possono essere OR bit per bit insieme.

ppDevice [out]

Tipo: ID3D10Device**

Indirizzo di un puntatore al dispositivo creato (vedere l'interfaccia ID3D10Device ).

Valore restituito

Tipo: HRESULT

Questa funzione restituisce uno dei codici restituiti Direct3D 10 seguenti.

Commenti

Questa funzione tenta di creare il dispositivo migliore per l'hardware. Prima di tutto, la funzione tenta di creare un dispositivo 10.1. Se non è possibile creare un dispositivo 10.1, la funzione tenta di creare un dispositivo 10.0. Se nessun dispositivo viene creato correttamente, la funzione restituisce E_FAIL.

Se l'applicazione deve creare solo un dispositivo 10.1 o un dispositivo 10.0, usare invece le funzioni seguenti:

Usare la funzione D3D10CreateDevice per creare solo un dispositivo Direct3D 10.0.
Usare la funzione D3D10CreateDevice1 per creare solo un dispositivo Direct3D 10.1.
Usare la funzione D3DX10GetFeatureLevel1 per ottenere un puntatore all'interfaccia ID3D10Device1 da un puntatore all'interfaccia ID3D10Device .

Un dispositivo Direct3D 10.1 può essere creato solo nei computer che eseguono Windows Vista Service Pack 1 o versione successiva e con l'hardware compatibile con Direct3D 10.1 installato. Tuttavia, è legale chiamare questa funzione nei computer che eseguono qualsiasi versione di Windows in cui è installata la DLL D3DX10.

Requisiti

Requisito	Valore
Intestazione	D3DX10Core.h

Vedi anche

Funzioni per utilizzo generico

Condividi tramite