D3DKMDT_STAGINGSURFACEDATA 구조체(d3dkmdt.h)

아티클
02/26/2024

D3DKMDT_STAGINGSURFACEDATA 구조는 애플리케이션의 백 버퍼에서 데이터가 전송되는 잠금 가능한 스테이징 화면을 설명합니다.

구문

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

멤버

[in] Width

스테이징 버퍼의 너비(픽셀)입니다.

[in] Height

스테이징 버퍼의 높이(픽셀)입니다.

[out] Pitch

스테이징 버퍼의 너비(바이트)입니다. 준비 버퍼를 잠글 수 있으므로 드라이버는 피치 값을 반환해야 합니다.

설명

D3DKMDT_STAGINGSURFACEDATA 구조체는 디스플레이 미니포트 드라이버의 DxgkDdiGetStandardAllocationDriverData 함수를 호출하여 Microsoft DirectX 그래픽 커널 하위 시스템에 의해 전달되어 잠금 가능한 스테이징 화면에 대한 설명을 생성합니다. 그래픽 하위 시스템은 디스플레이 미니포트 드라이버의 DxgkDdiPresent 함수를 호출하여 애플리케이션의 백 버퍼에서 스테이징 화면으로 데이터를 전송하는 비트 블록 전송(비트블렛) 요청을 실행합니다. 그러면 스테이징 화면이 잠기고 CPU에서 읽습니다.

주 표면으로 직접 비트 블록 전송을 수행할 수 없는 경우(예: 다중 모니터 또는 스프라이트의 경우) 현재 작업에 대해 스테이징 표면이 생성될 수 있습니다.

이 스테이징 화면은 항상 색당 8비트 RGB 픽셀 형식( D3DDDIFORMAT 열거형의 D3DDDIFMT_X8R8G8B8 값으로 지정됨)으로 만들어집니다. 스테이징 표면의 차원은 항상 백 버퍼의 차원과 일치하므로 스테이징 화면에 대한 현재 작업에는 스트레치 또는 축소 작업이 필요하지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	d3dkmdt.h(D3dkmddi.h 포함)