Funzione Direct3DCreate9 (d3d9helper.h)
Creare un oggetto IDirect3D9 e restituire 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. In questo modo, le applicazioni possono 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 adattatori (aggiungendo dispositivi al desktop o tramite l'ancoraggio frequente di un portatile), questi 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 sia compilata corrisponda alla versione della DLL di runtime installata nel computer. D3D_SDK_VERSION viene modificato solo nel runtime quando una modifica dell'intestazione (o altra modifica del codice) richiederà 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).
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9helper.h (include D3D9.h) |
| Libreria | D3d9.lib |
| DLL | D3d9.dll |