Função D3DX10CompileFromFile
Observação
Em vez de usar essa função herdada, recomendamos que você compile offline usando o compilador de linha de comando Fxc.exe ou use a API D3DCompile .
Compile um sombreador ou um efeito de um arquivo.
Sintaxe
HRESULT D3DX10CompileFromFile(
_In_ LPCTSTR pSrcFile,
_In_ const D3D_SHADER_MACRO *pDefines,
_In_ LPD3D10INCLUDE pInclude,
_In_ LPCSTR pFunctionName,
_In_ LPCSTR pProfile,
_In_ UINT Flags1,
_In_ UINT Flags2,
_In_ ID3DX10ThreadPump *pPump,
_Out_ ID3D10Blob **ppShader,
_Out_ ID3D10Blob **ppErrorMsgs,
_Out_ HRESULT *pHResult
);
Parâmetros
-
pSrcFile [in]
-
Tipo: LPCTSTR
O nome do arquivo que contém o código do sombreador. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados será resolvido para LPCSTR.
-
pDefines [in]
-
Tipo: const D3D_SHADER_MACRO*
Opcional. Ponteiro para uma matriz de definições de macro (consulte D3D_SHADER_MACRO). A última estrutura na matriz serve como um terminador e deve ter todos os membros definidos como 0. Se não for usado, defina pDefines como NULL.
-
pInclude [in]
-
Tipo: LPD3D10INCLUDE
Opcional. Ponteiro para uma interface ID3D10Include Interface para lidar com arquivos de inclusão. Definir isso como NULL causará um erro de compilação se um sombreador contiver um #include.
-
pFunctionName [in]
-
Tipo: LPCSTR
Nome da função de ponto de entrada do sombreador em que a execução do sombreador começa. Quando você compila um efeito, D3DX10CompileFromFile ignora pFunctionName; Recomendamos que você defina pFunctionName como NULL porque é uma boa prática de programação definir um parâmetro de ponteiro como NULL se a função chamada não a usar.
-
pProfile [in]
-
Tipo: LPCSTR
Uma cadeia de caracteres que especifica o modelo de sombreador; pode ser qualquer perfil no modelo de sombreador 2, no modelo de sombreador 3 ou no modelo de sombreador 4.
-
Flags1 [in]
-
Tipo: UINT
-
Flags2 [in]
-
Tipo: UINT
Efeito compilar sinalizadores. Quando você compila um sombreador e não um arquivo de efeito, D3DX10CompileFromFile ignora Flags2; Recomendamos que você defina Flags2 como zero porque é uma boa prática de programação definir um parâmetro nãopointer como zero se a função chamada não o usar.
-
pPump [in]
-
Tipo: ID3DX10ThreadPump*
Um ponteiro para uma interface de bomba de thread (consulte Interface ID3DX10ThreadPump). Use NULL para especificar que essa função não deve retornar até que seja concluída.
-
ppShader [out]
-
Tipo: ID3D10Blob**
Um ponteiro para uma Interface ID3D10Blob que contém o sombreador compilado, bem como qualquer depuração inserida e informações de tabela de símbolos.
-
ppErrorMsgs [out]
-
Tipo: ID3D10Blob**
Um ponteiro para uma Interface ID3D10Blob que contém uma listagem de erros e avisos ocorridos durante a compilação. Esses erros e avisos são idênticos à saída de depuração de um depurador.
-
pHResult [out]
-
Tipo: HRESULT*
Um ponteiro para o valor retornado. Pode ser NULL. Se pPump não for NULL, pHResult deverá ser um local de memória válido até que a execução assíncrona seja concluída.
Valor retornado
Tipo: HRESULT
O valor retornado é um dos valores listados em Códigos de Retorno do Direct3D 10.
Comentários
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
Confira também