Función D3DX10CompileFromFile

Nota

En lugar de usar esta función heredada, se recomienda compilar sin conexión mediante el compilador de línea de comandos Fxc.exe o usar la API D3DCompile .

 

Compile un sombreador o un efecto a partir de un archivo.

Sintaxis

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

Nombre del archivo que contiene el código del sombreador. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos se resuelve en LPCSTR.

pDefines [in]

Tipo: const D3D_SHADER_MACRO*

Opcional. Puntero a una matriz de definiciones de macros (vea D3D_SHADER_MACRO). La última estructura de la matriz actúa como terminador y debe tener todos los miembros establecidos en 0. Si no se usa, establezca pDefines en NULL.

pInclude [in]

Tipo: LPD3D10INCLUDE

Opcional. Puntero a una interfaz de interfaz ID3D10Include para controlar archivos de inclusión. Si se establece en NULL , se producirá un error de compilación si un sombreador contiene un #include.

pFunctionName [in]

Tipo: LPCSTR

Nombre de la función de punto de entrada del sombreador donde comienza la ejecución del sombreador. Al compilar un efecto, D3DX10CompileFromFile omite pFunctionName; Se recomienda establecer pFunctionName en NULL porque es una buena práctica de programación establecer un parámetro de puntero en NULL si la función llamada no la usará.

pProfile [in]

Tipo: LPCSTR

Cadena que especifica el modelo de sombreador; puede ser cualquier perfil en el modelo de sombreador 2, el modelo de sombreador 3 o el modelo 4 del sombreador.

Flags1 [in]

Tipo: UINT

Marcas de compilación del sombreador.

Flags2 [in]

Tipo: UINT

Marcas de compilación de efectos. Al compilar un sombreador y no un archivo de efecto, D3DX10CompileFromFile omite Flags2; se recomienda establecer Flags2 en cero porque es una buena práctica de programación establecer un parámetro que no sea de puntero en cero si la función llamada no la usará.

pPump [in]

Tipo: ID3DX10ThreadPump*

Puntero a una interfaz de bomba de subproceso (consulta ID3DX10ThreadPump Interface). Use NULL para especificar que esta función no debe devolverse hasta que se complete.

ppShader [out]

Tipo: ID3D10Blob**

Puntero a una interfaz ID3D10Blob que contiene el sombreador compilado, así como cualquier información incrustada de depuración y tabla de símbolos.

ppErrorMsgs [out]

Tipo: ID3D10Blob**

Puntero a una interfaz ID3D10Blob que contiene una lista de errores y advertencias que se produjeron durante la compilación. Estos errores y advertencias son idénticos a la salida de depuración de un depurador.

pHResult [out]

Tipo: HRESULT*

Puntero al valor devuelto. Puede ser NULL. Si pPump no es NULL, pHResult debe ser una ubicación de memoria válida hasta que se complete la ejecución asincrónica.

Valor devuelto

Tipo: HRESULT

El valor devuelto es uno de los valores enumerados en Códigos de retorno de Direct3D 10.

Observaciones

Requisitos

Requisito Value
Encabezado
D3DX10Async.h

Consulte también

Funciones de De uso general