Funzione D3DXCreateEffectFromResource
Creare un effetto da una descrizione dell'effetto ASCII o binario.
Sintassi
HRESULT D3DXCreateEffectFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ DWORD Flags,
_In_ LPD3DXEFFECTPOOL pPool,
_Out_ LPD3DXEFFECT *ppEffect,
_Out_ LPD3DXBUFFER *ppCompilationErrors
);
Parametri
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Puntatore al dispositivo.
-
hSrcModule [in]
-
Tipo: HMODULE
Handle in un modulo contenente la descrizione dell'effetto. Se questo parametro è NULL, verrà usato il modulo corrente.
-
pSrcResource [in]
-
Tipo: LPCTSTR
Puntatore alla risorsa. Questo parametro supporta sia stringhe Unicode che ANSI. Vedere la sezione Osservazioni.
-
pDefines [in]
-
Tipo: const D3DXMACRO*
Matrice facoltativa con terminazione NULL di strutture D3DXMACRO che descrivono le definizioni del preprocessore. Questo valore può essere NULL.
-
pInclude [in]
-
Tipo: LPD3DXINCLUDE
Puntatore di interfaccia facoltativo, ID3DXInclude, da usare per la gestione delle direttive #include. Se questo valore è NULL, #includes verrà rispettato durante la compilazione da un file o genererà un errore durante la compilazione da una risorsa o da una memoria.
-
Flag [in]
-
Tipo: DWORD
Se hSrcModule contiene un effetto di testo, i flag possono essere una combinazione di flag D3DXSHADER e flag D3DXFX ; in caso contrario, hSrcModule contiene un effetto binario e gli unici flag onorati sono flag D3DXFX. Il compilatore Direct3D 10 HLSL è ora l'impostazione predefinita. Per informazioni dettagliate, vedere Strumento del compilatore di effetti .
-
pPool [in]
-
Tipo: LPD3DXEFFECTPOOL
Puntatore a un oggetto ID3DXEffectPool da usare per i parametri condivisi. Se questo valore è NULL, non verranno condivisi parametri.
-
ppEffect [out]
-
Tipo: LPD3DXEFFECT*
Restituisce un buffer contenente l'effetto compilato.
-
ppCompilationErrors [out]
-
Tipo: LPD3DXBUFFER*
Restituisce un buffer contenente un elenco di errori di compilazione.
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Commenti
Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati LPCTSTR viene risolto in LPCSTR.
L'impostazione del compilatore determina anche la versione della funzione. Se è definito Unicode, la chiamata di funzione viene risolta in D3DXCreateEffectFromResourceW. In caso contrario, la chiamata di funzione viene risolta in D3DXCreateEffectFromResourceA perché vengono usate stringhe ANSI.
D3DXCreateEffectFromResource carica i dati da una risorsa di tipo RT_RCDATA. Per altre informazioni sulle risorse di Windows, vedere MSDN.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche