Funzione D3DXPreprocessShaderFromResource

Articolo
06/13/2023

Pre-elabora una risorsa shader senza eseguire la compilazione. Ciò risolve tutti i #defines e #includes, fornendo uno shader autonomo per la compilazione successiva.

Nota

Anziché usare questa funzione legacy, è consigliabile usare l'API D3DPreprocess .

Sintassi

HRESULT D3DXPreprocessShaderFromResource(
  _In_        HMODULE       hSrcModule,
  _In_        LPCSTR        pSrcResource,
  _In_  const D3DXMACRO     *pDefines,
  _In_        LPD3DXINCLUDE pInclude,
  _Out_       LPD3DXBUFFER  *ppShaderText,
  _Out_       LPD3DXBUFFER  *ppErrorMsgs
);

Parametri

hSrcModule [in]

Tipo: HMODULE

Handle al modulo che contiene la risorsa shader. Se questo valore è NULL, verrà usato il modulo corrente.

pSrcResource [in]

Tipo: LPCSTR

Stringa che rappresenta il nome della risorsa nel modulo.

pDefines [in]

Tipo: const D3DXMACRO*

Matrice di terminazione NULL facoltativa delle strutture D3DXMACRO . 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.

ppShaderText [out]

Tipo: LPD3DXBUFFER*

Restituisce un buffer contenente una singola stringa di grandi dimensioni che rappresenta il flusso di token formattato risultante.

ppErrorMsgs [out]

Tipo: LPD3DXBUFFER*

Restituisce un buffer contenente un elenco di errori e avvisi rilevati durante la compilazione. Questi sono gli stessi messaggi visualizzati dal debugger durante l'esecuzione in modalità di debug. Questo valore può essere NULL.

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

Vedi anche

Funzioni shader
D3DXPreprocessShaderFromFile
D3DXPreprocessShader