D3DHAL_DP2TEXTURESTAGESTATE 구조체(d3dhal.h)

D3DHAL_DP2COMMAND 구조체의 bCommand 멤버가 D3DDP2OP_TEXTURESTAGESTATE 설정되고 적절한 텍스처 스테이지 상태를 설정하는 데 사용되는 경우 하나 이상의 D3DHAL_DP2TEXTURESTAGESTATE 구조체가 D3dDrawPrimitives2 콜백에 의해 명령 버퍼에서 구문 분석됩니다.

구문

typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
  WORD  wStage;
  WORD  TSState;
  DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;

멤버

wStage

텍스처 상태를 업데이트할 텍스처 단계를 식별합니다. 이 멤버는 0~7 범위의 정수일 수 있으며, 가장 높은 번호가 매겨진 텍스처는 프레임 버퍼에 가장 가깝습니다.

TSState

업데이트할 텍스처 상태를 지정하는 D3DTEXTURESTAGESTATETYPE 열거형 값을 지정합니다. DirectX 9.0 이상 애플리케이션은 D3DSAMPLERSTATETYPE 열거형의 값을 사용하여 샘플러 텍스처 관련 렌더링 상태의 특성을 제어할 수 있습니다. DirectX 8.0 이하에서는 이러한 샘플러 상태가 D3DTEXTURESTAGESTATETYPE 열거형에 포함되었습니다. 런타임은 드라이버가 사용자 모드 샘플러 상태를 처리할 필요가 없도록 사용자 모드 샘플러 상태(D3DSAMP_Xxx)를 커널 모드 D3DTSS_Xxx 값에 매핑합니다. D3DTEXTURESTAGESTATETYPE 및 D3DSAMPLERSTATETYPE 대한 자세한 내용은 DirectX SDK 설명서를 참조하세요.

dwValue

드라이버가 TSState 로 식별된 텍스처 상태를 업데이트해야 하는 값을 지정합니다.

설명

D3dDrawPrimitives2 는 명령 버퍼에서 wStateCount D3DHAL_DP2TEXTURESTAGESTATE 구조를 처리해야 합니다. wStateCount의 값은 D3DHAL_DP2COMMAND 구조체에 지정됩니다.

각 D3DHAL_DP2TEXTURESTAGESTATE 구조에 대해 D3dDrawPrimitives2는 TSState를 기반으로 하는 새 값을 반영하도록 dwStage의 텍스처와 연결된 드라이버의 내부 텍스처 상태를 업데이트해야 합니다.

멀티텍스처를 지원하지 않는 드라이버는 텍스처 스테이지 0에 대한 지원만 구현해야 합니다.

다음 그림에서는 D3DDP2OP_TEXTURESTAGESTATE 명령과 세 개의 D3DHAL_DP2TEXTURESTAGESTATE 구조를 포함하는 샘플 명령 버퍼의 일부를 보여 줍니다. 드라이버는 그에 따라 0단계와 3단계의 프라이빗 텍스처 스테이지 상태를 업데이트해야 합니다.

요구 사항

요구 사항	값
헤더	d3dhal.h(D3dhal.h 포함)

추가 정보

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2