ID3DXEffect::Begin 메서드

  • 아티클

활성 기술을 시작합니다.

구문

HRESULT Begin(
  [out] UINT  *pPasses,
  [in]  DWORD Flags
);

매개 변수

pPasses [out]

형식: UINT*

현재 기술을 렌더링하는 데 필요한 패스 수를 나타내는 반환된 값에 대한 포인터입니다.

Flags [in]

형식: DWORD

효과에 의해 수정된 상태가 저장 및 복원되는지 여부를 결정하는 DWORD입니다. 기본값 0은 ID3DXEffect::Begin 및 ID3DXEffect::End 가 효과에 의해 수정된 모든 상태(픽셀 및 꼭짓점 셰이더 상수 포함)를 저장하고 복원할 것을 지정합니다. 유효한 플래그는 효과 상태 저장 및 복원 플래그에서 볼 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA 중 하나일 수 있습니다.

설명

애플리케이션은 ID3DXEffect::Begin을 호출하여 효과 시스템에서 하나의 활성 기술을 설정합니다. 효과 시스템은 상태 블록의 기술에 의해 변경될 수 있는 모든 파이프라인 상태를 캡처하여 응답합니다. 애플리케이션은 상태 블록을 사용하여 원래 상태를 복원하는 ID3DXEffect::End를 호출하여 기술의 끝을 알릴 수 있습니다. 따라서 효과 시스템은 기술이 활성화될 때 상태를 저장하고 기술이 종료될 때 상태를 복원합니다. 이 저장 및 복원 기능을 사용하지 않도록 선택하는 경우 D3DXFX_DONOTSAVESAMPLERSTATE 참조하세요.

ID3DXEffect::Begin 및 ID3DXEffect::End 쌍 내에서 애플리케이션은 ID3DXEffect::BeginPass를 사용하여 활성 패스를 설정하고, 패스가 활성화된 후 상태 변경이 발생한 경우 ID3DXEffect::CommitChanges를 사용하고, ID3DXEffect::EndPass를 사용하여 활성 패스를 종료합니다.

요구 사항

요구 사항 값
헤더
D3DX9Effect.h
라이브러리
D3dx9.lib

추가 정보

ID3DXEffect