Funzione D3DX10CreateEffectPoolFromFile

Articolo
06/13/2023

Creare un pool di effetti da un file di effetto.

Sintassi

HRESULT D3DX10CreateEffectPoolFromFile(
  _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_        ID3DX10ThreadPump  *pPump,
  _Out_       ID3D10EffectPool   **ppEffectPool,
  _Out_       ID3D10Blob         **ppErrors,
  _Out_       HRESULT            *pHResult
);

Parametri

pFileName [in]

Tipo: LPCTSTR

Nome file dell'effetto. 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.

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.

ppEffectPool [out]

Tipo: ID3D10EffectPool**

Indirizzo di un puntatore al pool di effetti (vedere ID3D10EffectPool Interface).

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.

Commenti

In questo esempio viene creato un pool di effetti dall'effetto usato nell'esempio BasicHLSL10.

   
// Create an effect pool from an effect in memory
ID3D10EffectPool * l_pEffectPool = NULL;
ID3D10Blob* l_pBlob_Errors = NULL;
WCHAR str[MAX_PATH];
hr = DXUTFindDXSDKMediaFileCch( str, MAX_PATH, L"BasicHLSL10.fx" );
hr = D3DX10CreateEffectPoolFromFile( str, 
    NULL, NULL, D3D10_SHADER_ENABLE_STRICTNESS, 
    0, pd3dDevice, NULL, &l_pEffectPool,
    &l_pBlob_Errors );

Requisiti

Requisito	Valore
Intestazione	D3DX10Async.h

Vedi anche

Funzioni per utilizzo generico

Condividi tramite