D3DKMDT_SHADOWSURFACEDATA 구조체(d3dkmdt.h)

아티클
02/06/2025

D3DKMDT_SHADOWSURFACEDATA 구조는 지정된 디스플레이 모드에 대한 형식 및 해상도의 기본 표면과 일치하는 잠금 가능한 그림자 표면을 설명합니다.

통사론

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

회원

[in] Width

표면의 너비(픽셀)입니다. 드라이버는 너비 값을 반환합니다.

[in] Height

표면의 높이(픽셀)입니다. 드라이버는 높이 값을 반환합니다.

[in] Format

표면의 픽셀 형식을 나타내는 D3DDDIFORMAT형식화된 값입니다. 드라이버는 형식 값을 반환합니다.

[out] Pitch

표면의 너비(바이트)입니다. 섀도 표면을 잠글 수 있으므로 드라이버는 피치 값을 반환해야 합니다.

발언

D3DKMDT_SHADOWSURFACEDATA 구조는 디스플레이 미니포트 드라이버의 DxgkDdiGetStandardAllocationDriverData 함수를 호출하여 잠금 가능한 섀도 화면에 대한 설명을 생성하는 Microsoft DirectX 그래픽 커널 하위 시스템에 의해 전달됩니다. DirectX 그래픽 커널 하위 시스템은 디스플레이 미니포트 드라이버의 DxgkDdiCreateAllocation 함수에 대한 호출에서 설명을 사용하여 잠금 가능한 그림자 표면을 만듭니다.

CPU는 잠긴 그림자 표면에 그려지고, 그림자 표면의 잠금을 해제한 다음, 그림자 표면에서 일치하는 공유 주 표면으로 DxgkDdiPresent 함수를 통해 비트 블록 전송(비트블렛) 요청을 실행합니다. 공유 기본 표면에서 섀도 표면으로 데이터를 전송하기 위해 비트 블록 전송 요청도 발급됩니다.

그림자 및 공유 기본 표면의 원본 및 대상 형식과 차원이 항상 일치하기 때문에 그림자 표면에서 또는 그림자 표면으로 데이터를 복사할 때는 색 변환, 늘이기 또는 축소 작업이 필요하지 않습니다.