Funzione D3DXCreateEffect

Creare un effetto da una descrizione dell'effetto ASCII o binario.

Sintassi

HRESULT D3DXCreateEffect(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        LPCVOID           pSrcData,
  _In_        UINT              SrcDataLen,
  _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 che creerà l'effetto. Vedere IDirect3DDevice9.

pSrcData [in]

Tipo: LPCVOID

Puntatore a un buffer contenente una descrizione dell'effetto.

SrcDataLen [in]

Tipo: UINT

Lunghezza dei dati dell'effetto, in byte.

pDefines [in]

Tipo: const D3DXMACRO*

Matrice facoltativa con terminazione NULL delle 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 gestire le direttive di #include. Se questo valore è NULL, #includes verrà rispettato quando si compila da un file o si verificherà un errore quando viene compilato da una risorsa o da una memoria.

Flag [in]

Tipo: DWORD

Se pSrcData contiene un effetto di testo, i flag possono essere una combinazione di flag D3DXSHADER e flag D3DXFX ; in caso contrario, pSrcData contiene un effetto binario e gli unici flag onorati sono flag D3DXFX. Il compilatore Direct3D 10 HLSL è ora il valore predefinito. Per informazioni dettagliate, vedere Strumento del compilatore effetto .

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 puntatore a un'interfaccia ID3DXEffect .

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 è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Requisiti

Requisito Valore
Intestazione
D3DX9Effect.h
Libreria
D3dx9.lib

Vedi anche

Funzioni effetto

D3DXCompileShader

D3DXCompileShaderFromResource