Funzione D3DX10CreateEffectFromFile

Articolo
06/13/2023

Creare un effetto da un file.

Sintassi

HRESULT D3DX10CreateEffectFromFile(
  _In_        LPCTSTR            pFileName,
  _In_  const D3D_SHADER_MACRO *pDefines,
  _In_        ID3D10Include      *pInclude,
  _In_        LPCSTR             pProfile,
  _In_        UINT               HLSLFlags,
  _In_        UINT               FXFlags,
  _In_        ID3D10Device       *pDevice,
  _In_        ID3D10EffectPool   *pEffectPool,
  _In_        ID3DX10ThreadPump  *pPump,
  _Out_       ID3D10Effect       **ppEffect,
  _Out_       ID3D10Blob         **ppErrors,
  _Out_       HRESULT            *pHResult
);

Parametri

pFileName [in]

Tipo: LPCTSTR

Nome del file di effetto ASCII. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati viene risolto in LPCSTR.

pDefines [in]

Tipo: const D3D_SHADER_MACRO*

Matrice con terminazione NULL di macro shader (vedere D3D_SHADER_MACRO); impostare questa opzione su NULL per specificare nessuna macro.

pInclude [in]

Tipo: ID3D10Include*

Puntatore a un'interfaccia di inclusione (vedere INTERFACCIA ID3D10Include). Questo parametro può essere NULL.

pProfile [in]

Tipo: LPCSTR

Stringa che specifica il profilo shader o il modello shader.

HLSLFlags [in]

Tipo: UINT

Opzioni di compilazione HLSL (vedere costanti D3D10_SHADER).

FXFlags [in]

Tipo: UINT

Opzioni di compilazione degli effetti (vedere Compilazione e flag effetto).

pDevice [in]

Tipo: ID3D10Device*

Puntatore al dispositivo (vedere ID3D10Device Interface) che userà le risorse.

pEffectPool [in]

Tipo: ID3D10EffectPool*

Puntatore a un pool di effetti (vedere ID3D10EffectPool Interface) per condividere le variabili tra gli effetti.

pPump [in]

Tipo: ID3DX10ThreadPump*

Puntatore a un'interfaccia della pompa del thread (vedere ID3DX10ThreadPump Interface). Usare NULL per specificare che questa funzione non deve restituire finché non viene completata.

ppEffect [out]

Tipo: ID3D10Effect**

Indirizzo di un puntatore all'effetto (vedere ID3D10Effect Interface) creato.

ppErrors [out]

Tipo: ID3D10Blob**

Indirizzo di un puntatore alla memoria (vedere ID3D10Blob Interface) che contiene errori di compilazione degli effetti, se presenti.

pHResult [out]

Tipo: HRESULT*

Puntatore al valore restituito. Può essere NULL. Se pPump non è NULL, pHResult deve essere un percorso di memoria valido fino al completamento dell'esecuzione asincrona.

Valore restituito

Tipo: HRESULT

Il valore restituito è uno dei valori elencati in Codici restituiti Direct3D 10.

Requisiti

Requisito	Valore
Intestazione	D3DX10Async.h

Vedi anche

Funzioni per utilizzo generico

Condividi tramite