Funzione Direct3DCreate9 (d3d9.h)

Creare un oggetto IDirect3D9 e restituirvi un'interfaccia.

Sintassi

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

Parametri

SDKVersion

Tipo: UINT

Il valore di questo parametro deve essere D3D_SDK_VERSION. Vedere la sezione Osservazioni.

Valore restituito

Tipo: IDirect3D9*

In caso di esito positivo, questa funzione restituisce un puntatore a un'interfaccia IDirect3D9 ; in caso contrario, viene restituito un puntatore NULL .

Commenti

L'oggetto Direct3D è il primo oggetto COM Direct3D che l'applicazione grafica deve creare e l'ultimo oggetto che l'applicazione deve rilasciare. Le funzioni per enumerare e recuperare le funzionalità di un dispositivo sono accessibili tramite l'oggetto Direct3D. Ciò consente alle applicazioni di selezionare i dispositivi senza crearli.

Creare un oggetto IDirect3D9 come illustrato di seguito:

LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

L'interfaccia IDirect3D9 supporta l'enumerazione di schede di visualizzazione attive e consente la creazione di oggetti IDirect3DDevice9 . Se l'utente aggiunge dinamicamente schede (aggiungendo dispositivi al desktop o eseguendo l'ancoraggio rapido di un portatile), tali dispositivi non verranno inclusi nell'enumerazione . La creazione di una nuova interfaccia IDirect3D9 espone i nuovi dispositivi.

D3D_SDK_VERSION viene passato a questa funzione per assicurarsi che i file di intestazione in cui un'applicazione venga compilata corrispondano alla versione della DLL di runtime installata nel computer. D3D_SDK_VERSION viene modificato nel runtime solo quando una modifica dell'intestazione (o un'altra modifica del codice) richiede la ricompilazione di un'applicazione. Se questa funzione ha esito negativo, indica che la versione del file di intestazione non corrisponde alla versione della DLL di runtime.

Per un esempio, vedere Creazione di un dispositivo (Direct3D 9).For an example, see Creating a Device (Direct3D 9).

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d9.h (include D3D9.h)
Libreria	D3d9.lib
DLL	D3d9.dll

Vedi anche

Funzioni Direct3D