D3DXCreateEffectEx 함수
ASCII 또는 이진 효과 설명에서 효과를 만듭니다. 이 함수는 애플리케이션이 효과 시스템에서 무시되는 매개 변수를 제어할 수 있도록 하는 D3DXCreateEffect 의 확장 버전입니다.
구문
HRESULT D3DXCreateEffectEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataLen,
_In_ const D3DXMACRO *pDefines,
_In_ LPD3DXINCLUDE pInclude,
_In_ LPCSTR pSkipConstants,
_In_ DWORD Flags,
_In_ LPD3DXEFFECTPOOL pPool,
_Out_ LPD3DXEFFECT *ppEffect,
_Out_ LPD3DXBUFFER *ppCompilationErrors
);
매개 변수
-
pDevice [in]
-
효과를 만들 디바이스에 대한 포인터입니다. IDirect3DDevice9를 참조하세요.
-
pSrcData [in]
-
형식: LPCVOID
효과 설명을 포함하는 버퍼에 대한 포인터입니다.
-
SrcDataLen [in]
-
형식: UINT
효과 데이터의 길이(바이트)입니다.
-
pDefines [in]
-
형식: const D3DXMACRO*
전처리기 정의를 설명하는 D3DXMACRO 구조체의 선택적 NULL 종료 배열입니다. 이 값은 NULL일 수 있습니다.
-
pInclude [in]
-
형식: LPD3DXINCLUDE
#include 지시문을 처리하는 데 사용할 선택적 인터페이스 포인터 ID3DXInclude입니다. 이 값이 NULL인 경우 파일에서 컴파일할 때 #includes 적용되거나 리소스 또는 메모리에서 컴파일될 때 오류가 발생합니다.
-
pSkipConstants [in]
-
형식: LCSTTR
효과 시스템에서 무시되는 효과 매개 변수의 문자열입니다. 문자열은 NULL 을 종료해야 하며 세미콜론으로 구분된 각 애플리케이션 관리 상수의 이름을 포함해야 합니다.
-
Flags [in]
-
형식: DWORD
pSrcData에 텍스트 효과가 포함된 경우 플래그는 D3DXSHADER 플래그와 D3DXFX 플래그의 조합일 수 있습니다. 그렇지 않으면 pSrcData에 이진 효과가 포함되고 D3DXFX 플래그만 적용됩니다. 이제 Direct3D 10 HLSL 컴파일러가 기본값입니다. 자세한 내용은 효과 컴파일러 도구를 참조하세요.
-
pPool [in]
-
형식: LPD3DXEFFECTPOOL
공유 매개 변수에 사용할 ID3DXEffectPool 개체에 대한 포인터입니다. 이 값이 NULL이면 매개 변수가 공유되지 않습니다.
-
ppEffect [out]
-
형식: LPD3DXEFFECT*
ID3DXEffect 인터페이스에 대한 포인터를 반환합니다.
-
ppCompilationErrors [out]
-
형식: LPD3DXBUFFER*
컴파일 오류 목록이 포함된 버퍼를 반환합니다.
반환 값
형식: HRESULT
함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY 중 하나일 수 있습니다.
설명
이 함수는 애플리케이션이 애플리케이션에서 관리할 효과 상수를 지정할 수 있도록 하는 D3DXCreateEffect 의 확장 버전입니다. 애플리케이션에서 관리하는 상수는 효과 시스템에서 무시됩니다. 즉, 애플리케이션은 상수를 초기화하고 적절한 경우 상태를 저장하고 복원하는 역할을 담당합니다.
이 함수는 pSkipConstants의 각 상수를 검사하여 다음을 확인합니다.
- 상수 레지스터에 바인딩됩니다.
- HLSL 셰이더 코드에서만 사용됩니다.
상수가 효과에 없는 문자열에 이름이 지정되면 무시됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보