Функция D3DXCompileShaderFromResource
Скомпилируйте файл шейдера.
Примечание
Вместо использования этой устаревшей функции рекомендуется выполнять компиляцию в автономном режиме с помощью компилятора командной строки Fxc.exe или API D3DCompile .
Синтаксис
HRESULT D3DXCompileShaderFromResource(
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ LPCSTR pFunctionName,
_In_ LPCSTR pProfile,
_In_ DWORD Flags,
_Out_ LPD3DXBUFFER *ppShader,
_Out_ LPD3DXBUFFER *ppErrorMsgs,
_Out_ LPD3DXCONSTANTTABLE *ppConstantTable
);
Параметры
-
hSrcModule [in]
-
Тип: HMODULE
Дескриптор модуля, содержащего описание эффекта. Если этот параметр имеет значение NULL, будет использоваться текущий модуль.
-
pSrcResource [in]
-
Тип: LPCSTR
Указатель на строку, указывающую имя ресурса.
-
pDefines [in]
-
Тип: const D3DXMACRO*
Необязательный массив структур D3DXMACRO с завершением NULL. Это значение может иметь значение NULL.
-
pВключение [in]
-
Тип: LPD3DXINCLUDE
Необязательный указатель интерфейса ID3DXInclude, используемый для обработки директив #include. Если это значение равно NULL, #includes будет учитываться при компиляции из файла или будет возникать ошибка при компиляции из ресурса или памяти.
-
pFunctionName [in]
-
Тип: LPCSTR
Указатель на функцию точки входа шейдера, с которой начинается выполнение.
-
pProfile [in]
-
Тип: LPCSTR
Указатель на профиль шейдера, который определяет набор инструкций шейдера. Список доступных профилей см. в разделе D3DXGetVertexShaderProfile или D3DXGetPixelShaderProfile .
-
Флаги [в]
-
Тип: DWORD
Параметры компиляции, определенные различными флагами. Компилятор Direct3D 10 HLSL теперь используется по умолчанию. Дополнительные сведения см. в разделе Флаги D3DXSHADER .
-
ppShader [out]
-
Тип: LPD3DXBUFFER*
Возвращает буфер, содержащий созданный шейдер. Этот буфер содержит скомпилированный код шейдера, а также все внедренные сведения об отладке и таблице символов.
-
ppErrorMsgs [out]
-
Тип: LPD3DXBUFFER*
Возвращает буфер, содержащий список ошибок и предупреждений, которые были обнаружены во время компиляции. Это те же сообщения, которые отображает отладчик при работе в режиме отладки. Это значение может иметь значение NULL.
-
ppConstantTable [out]
-
Тип: LPD3DXCONSTANTTABLE*
Возвращает интерфейс ID3DXConstantTable , который можно использовать для доступа к константам шейдера. Это значение может иметь значение NULL. При компиляции приложения с учетом больших адресов (т. е. для обработки адресов размером более 2 ГБ используется параметр компоновщика /LARGEADDRESSAWARE), этот параметр использовать нельзя, и ему необходимо задать значение NULL. Вместо этого необходимо использовать функцию D3DXGetShaderConstantTableEx для получения таблицы констант шейдера, внедренной в шейдер. В этом вызове D3DXGetShaderConstantTableEx необходимо передать флаг D3DXCONSTTABLE_LARGEADDRESSAWARE параметру Flags , чтобы указать для доступа до 4 ГБ виртуального адресного пространства.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел