Metodo IDirect3D9Ex::CreateDeviceEx (d3d9.h)

Articolo
08/23/2023

Crea un dispositivo per rappresentare la scheda di visualizzazione.

Sintassi

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
);

Parametri

[in] Adapter

Tipo: UINT

Numero ordinale che indica l'adattatore di visualizzazione. D3DADAPTER_DEFAULT è sempre la scheda di visualizzazione primaria.

[in] DeviceType

Tipo: D3DDEVTYPE

Specifica il tipo di dispositivo. Vedere D3DDEVTYPE. Se il tipo di dispositivo desiderato non è disponibile, il metodo avrà esito negativo.

[in] hFocusWindow

Tipo: HWND

La finestra messa a fuoco avvisa Direct3D quando un'applicazione passa dalla modalità in primo piano alla modalità in background. Per la modalità schermo intero, la finestra specificata deve essere una finestra di primo livello. Per la modalità finestra, questo parametro può essere NULL solo se il membro hDeviceWindow di pPresentationParameters è impostato su un valore non NULL valido.

[in] BehaviorFlags

Tipo: DWORD

Combinazione di una o più opzioni (vedere D3DCREATE) che controllano la creazione del dispositivo.

[in, out] pPresentationParameters

Tipo: D3DPRESENT_PARAMETERS*

Puntatore a una struttura D3DPRESENT_PARAMETERS , che descrive i parametri di presentazione da creare per il dispositivo. Se BehaviorFlags specifica D3DCREATE_ADAPTERGROUP_DEVICE, questo parametro è una matrice. Indipendentemente dal numero di teste esistenti, viene creata automaticamente una sola superficie di profondità/stencil.

Questo parametro è sia un input che un parametro di output. La chiamata a questo metodo può modificare diversi membri, tra cui:

Se BackBufferCount, BackBufferWidth e BackBufferHeight sono 0 prima che venga chiamato il metodo, verranno modificati quando termina il metodo.
Se BackBufferFormat è uguale a D3DFMT_UNKNOWN prima che venga chiamato il metodo, verrà modificato quando il metodo viene restituito.

[in, out] pFullscreenDisplayMode

Tipo: D3DDISPLAYMODEEX*

Modalità di visualizzazione per quando il dispositivo è impostato su schermo intero. Vedere D3DDISPLAYMODEEX. Se BehaviorFlags specifica D3DCREATE_ADAPTERGROUP_DEVICE, questo parametro è una matrice. Questo parametro deve essere NULL per la modalità finestra.

[out, retval] ppReturnedDeviceInterface

Tipo: IDirect3DDevice9Ex**

Indirizzo di un puntatore all'oggetto IDirect3DDevice9Ex restituito, che rappresenta il dispositivo creato.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce S_OK quando il dispositivo di rendering insieme ai buffer swapchain vengono creati correttamente. D3DERR_DEVICELOST viene restituito quando viene rilevato un errore diverso dall'input del chiamante non valido.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9.h
Libreria	D3D9.lib

Vedi anche

IDirect3D9Ex

Condividi tramite