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	D3DX9Effect.h
Libreria	D3dx9.lib

Vedi anche

Funzioni effetto

D3DXCompileShader

D3DXCompileShaderFromResource