Função D3DX10CreateEffectPoolFromFile

  • Artigo

Crie um pool de efeitos com base em um arquivo de efeito.

Sintaxe

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
);

Parâmetros

pFileName [in]

Tipo: LPCTSTR

O nome do arquivo de efeito. 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*

Uma matriz terminada em NULL de macros de sombreador (consulte D3D_SHADER_MACRO); defina isso como NULL para não especificar macros.

pInclude [in]

Tipo: ID3D10Include*

Um ponteiro para uma interface include (consulte Interface ID3D10Include). Este parâmetro pode ser NULL.

pProfile [in]

Tipo: LPCSTR

Uma cadeia de caracteres que especifica o perfil de sombreador ou o modelo de sombreador.

HLSLFlags [in]

Tipo: UINT

Opções de compilação HLSL (consulte Constantes de D3D10_SHADER).

FXFlags [in]

Tipo: UINT

Opções de compilação de efeito (consulte Compilar e Sinalizadores de Efeito).

pDevice [in]

Tipo: ID3D10Device*

Um ponteiro para o dispositivo (consulte Interface ID3D10Device) que usará os recursos.

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.

ppEffectPool [out]

Tipo: ID3D10EffectPool**

O endereço de um ponteiro para o pool de efeitos (consulte Interface ID3D10EffectPool).

ppErrors [out]

Tipo: ID3D10Blob**

O endereço de um ponteiro para a memória (consulte Interface ID3D10Blob) que contém erros de compilação de efeito, se houver algum.

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

Este exemplo cria um pool de efeitos do efeito usado no Exemplo 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 );

Requisitos

Requisito Valor
parâmetro
D3DX10Async.h

Confira também

Funções Uso Geral