Функция D3DXCreateEffectCompilerFromFile

Статья
06/13/2023

Создает компилятор эффектов на основе описания эффекта ASCII.

Синтаксис

HRESULT D3DXCreateEffectCompilerFromFile(
  _In_        LPCTSTR              pSrcFile,
  _In_  const D3DXMACRO            *pDefines,
  _In_        LPD3DXINCLUDE        pInclude,
  _In_        DWORD                Flags,
  _Out_       LPD3DXEFFECTCOMPILER *ppEffectCompiler,
  _Out_       LPD3DXBUFFER         *ppParseErrors
);

Параметры

pSrcFile [in]

Тип: LPCTSTR

Указатель на имя файла. Этот параметр поддерживает строки Юникода и ANSI. См. заметки.

pDefines [in]

Тип: const D3DXMACRO*

Необязательный массив структур D3DXMACRO с завершением NULL, описывающий определения препроцессора. Это значение может иметь значение NULL.

pВключение [in]

Тип: LPD3DXINCLUDE

Необязательный указатель интерфейса ID3DXInclude, используемый для обработки директив #include. Если это значение равно NULL, #includes будет учитываться при компиляции из файла или вызвать ошибку при компиляции из ресурса или памяти.

Флаги [в]

Тип: DWORD

Параметры компиляции, определенные различными флагами (см . раздел Флаги D3DXSHADER). Компилятор Direct3D 10 HLSL теперь используется по умолчанию. Дополнительные сведения см. в разделе Effect-Compiler Tool .

ppEffectCompiler [out]

Тип: LPD3DXEFFECTCOMPILER*

Адрес указателя на интерфейс ID3DXEffectCompiler , содержащий компилятор эффекта.

ppParseErrors [out]

Тип: LPD3DXBUFFER*

Адрес указателя на интерфейс ID3DXBuffer , содержащий все сообщения об ошибках, возникшие во время компиляции. Для этого параметра можно задать значение NULL , чтобы игнорировать сообщения об ошибках.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXCreateEffectCompilerFromFileW. В противном случае вызов функции разрешается в D3DXCreateEffectCompilerFromFileA, так как используются строки ANSI.

Требования

Требование	Значение
Заголовок	D3DX9Effect.h
Библиотека	D3dx9.lib

См. также раздел

Функции эффектов
D3DXCreateEffectCompiler
D3DXCreateEffectCompilerFromResource