Функция D3DXCreateEffectFromFile

Создание результата из описания ASCII или двоичного действия.

Синтаксис

HRESULT D3DXCreateEffectFromFile(
  _In_        LPDIRECT3DDEVICE9 pDevice,
  _In_        LPCTSTR           pSrcFile,
  _In_  const D3DXMACRO         *pDefines,
  _In_        LPD3DXINCLUDE     pInclude,
  _In_        DWORD             Flags,
  _In_        LPD3DXEFFECTPOOL  pPool,
  _Out_       LPD3DXEFFECT      *ppEffect,
  _Out_       LPD3DXBUFFER      *ppCompilationErrors
);

Параметры

пдевице [ окне]

Тип: LPDIRECT3DDEVICE9

Указатель на устройство, которое создаст результат. См. IDirect3DDevice9.

псркфиле [ окне]

Тип: LPCTSTR

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

пдефинес [ окне]

Тип: const D3DXMACRO *

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

пинклуде [ окне]

Тип: LPD3DXINCLUDE

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

Флаги [ окне]

Тип: DWORD

Если псркфиле содержит текстовый результат, флаги могут быть сочетанием флагов D3DXSHADER и D3DXFX . в противном случае псркфиле содержит двоичный результат, а только соблюдаются флаги D3DXFX. Компилятор Direct3D 10 HLSL теперь является значением по умолчанию. Дополнительные сведения см. в разделе средство компилятора Effect .

ппул [ окне]

Тип: LPD3DXEFFECTPOOL

Указатель на объект ID3DXEffectPool , используемый для общих параметров. Если это значение равно null, общий доступ к параметрам не предоставляется.

ппеффект [ заполняет]

Тип: LPD3DXEFFECT*

Возвращает указатель на буфер, содержащий скомпилированный результат. См. ID3DXEffect.

ппкомпилатионеррорс [ заполняет]

Тип: LPD3DXBUFFER*

Возвращает указатель на буфер, содержащий список ошибок компиляции. См. ID3DXBuffer.

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

Тип: HRESULT

Если функция выполнена успешно, возвращается значение D3D _ ОК. Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих: D3DERR _ инвалидкалл, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY.

Комментарии

Если для параметров компилятора требуется Юникод, тип данных LPCTSTR разрешается в ЛПКВСТР. В противном случае тип данных LPCTSTR разрешается в LPCSTR.

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

Требования

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

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

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

D3DXCompileShader

D3DXCompileShaderFromResource