DXGI_PRESENT_PARAMETERS 구조체(dxgi1_2.h)

운영 체제에서 프레젠테이션을 최적화하는 데 도움이 되는 현재에 대한 정보를 설명합니다.

구문

typedef struct DXGI_PRESENT_PARAMETERS {
  UINT  DirtyRectsCount;
  RECT  *pDirtyRects;
  RECT  *pScrollRect;
  POINT *pScrollOffset;
} DXGI_PRESENT_PARAMETERS;

멤버

DirtyRectsCount

제공된 프레임의 백 버퍼에서 업데이트한 업데이트된 사각형의 수입니다. 운영 체제는 이 정보를 사용하여 프레젠테이션을 최적화합니다. 이 멤버를 0으로 설정하여 전체 프레임을 업데이트했음을 나타낼 수 있습니다.

pDirtyRects

제공된 프레임의 백 버퍼에서 업데이트하는 업데이트된 사각형 목록입니다. 애플리케이션은 런타임에 보고하는 각 사각형의 모든 단일 픽셀을 업데이트해야 합니다. 애플리케이션은 픽셀이 이전 프레임에서 저장된다고 가정할 수 없습니다. 더티 사각형을 업데이트하는 방법에 대한 자세한 내용은 비고를 참조하세요. DirtyRectsCount가 0인 경우 이 멤버를 NULL로 설정할 수 있습니다. 애플리케이션은 더티 사각형 외부의 픽셀을 업데이트해서는 안 됩니다.

pScrollRect

스크롤된 사각형에 대한 포인터입니다. 스크롤된 사각형은 런타임 비트 블록이 (비트블렛) 콘텐츠를 전송하는 이전 프레임의 사각형입니다. 또한 런타임은 스크롤된 사각형을 사용하여 터미널 서버 및 간접 표시 시나리오에서 프레젠테이션을 최적화합니다.

스크롤된 사각형은 스크롤된 콘텐츠로 채워진 현재 프레임의 영역인 대상 사각형도 설명합니다. 이 멤버를 NULL 로 설정하여 이전 프레임에서 스크롤된 콘텐츠가 없음을 나타낼 수 있습니다.

pScrollOffset

원본 사각형(이전 프레임)에서 대상 사각형(현재 프레임)으로 이동되는 스크롤된 영역의 오프셋에 대한 포인터입니다. 이 멤버를 NULL 로 설정하여 오프셋 없음을 나타낼 수 있습니다.

설명

이 구조체는 Present1 메서드에서 사용됩니다.

스크롤 사각형과 더티 사각형 목록이 겹칠 수 있습니다. 이 경우 더티 사각형이 우선합니다. 그러면 애플리케이션에 스크롤된 영역 위에 동적 콘텐츠 조각이 있을 수 있습니다. 예를 들어 애플리케이션은 페이지를 스크롤하고 동시에 비디오를 재생할 수 있습니다.

다음 다이어그램과 좌표는 이 예제를 보여 줍니다.

DirtyRectsCount = 2
pDirtyRects[ 0 ] = { 10, 30, 40, 50 } // Video
pDirtyRects[ 1 ] = { 0, 70, 50, 80 } // New line
*pScrollRect = { 0, 0, 50, 70 }
*pScrollOffset = { 0, -10 }

애플리케이션이 렌더링하는 이전 프레임 및 콘텐츠의 일부가 결합되어 운영 체제가 디스플레이 화면에 표시하는 최종 프레임을 생성합니다. 창의 대부분은 이전 프레임에서 스크롤됩니다. 애플리케이션은 스크롤로 인해 표시되는 새 콘텐츠 청크로 비디오 프레임을 업데이트해야 합니다.

파선 사각형은 현재 프레임의 스크롤 사각형을 표시합니다. 스크롤 사각형은 pScrollRect 멤버에 의해 지정됩니다. 화살표는 스크롤 오프셋을 표시합니다. 스크롤 오프셋은 pScrollOffset 멤버에 의해 지정됩니다. 채워진 사각형은 애플리케이션이 새 콘텐츠로 업데이트한 더티 사각형을 표시합니다. 채워진 사각형은 DirtyRectsCount 및 pDirtyRects 멤버에 의해 지정됩니다.

스크롤 사각형 및 오프셋은 DXGI_SWAP_EFFECT_DISCARD 또는 DXGI_SWAP_EFFECT_SEQUENTIAL 현재 옵션에 대해 지원되지 않습니다. 다중 샘플링 스왑 체인에는 더티 사각형 및 스크롤 사각형이 지원되지 않습니다.

컴퍼지션 및 필요한 비트블렛의 실제 구현은 비트블렛 모델과 대칭 이동 모델에 따라 다릅니다. 이러한 모델에 대한 자세한 내용은 DXGI Flip Model을 참조하세요.

대칭 이동 모델 스왑 체인 및 프레젠테이션 최적화에 대한 자세한 내용은 대칭 이동 모델, 더티 사각형 및 스크롤된 영역으로 프레젠테이션 향상을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2용 Windows Server 2012 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
머리글	dxgi1_2.h

추가 정보

DXGI 구조체