IDirect3DDevice9::P resent 메서드(d3d9.h)

디바이스가 소유한 백 버퍼 시퀀스에서 다음 버퍼의 내용을 표시합니다.

구문

HRESULT Present(
  [in] const RECT    *pSourceRect,
  [in] const RECT    *pDestRect,
  [in] HWND          hDestWindowOverride,
  [in] const RGNDATA *pDirtyRegion
);

매개 변수

[in] pSourceRect

형식: const RECT*

D3DSWAPEFFECT_COPY 사용하여 스왑 체인을 만들지 않는 한 NULL 이어야 하는 값에 대한 포인터입니다. pSourceRect는 원본 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. NULL이면 전체 원본 표면이 표시됩니다. 사각형이 원본 표면을 초과하면 사각형이 원본 표면으로 잘립니다.

[in] pDestRect

형식: const RECT*

D3DSWAPEFFECT_COPY 사용하여 스왑 체인을 만들지 않는 한 NULL 이어야 하는 값에 대한 포인터입니다. pDestRect는 창 클라이언트 좌표에서 대상 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. NULL이면 전체 클라이언트 영역이 채워집니다. 사각형이 대상 클라이언트 영역을 초과하면 사각형이 대상 클라이언트 영역으로 잘립니다.

[in] hDestWindowOverride

형식: HWND

클라이언트 영역을 이 프레젠테이션의 대상으로 사용하는 대상 창에 대한 포인터입니다. 이 값이 NULL인 경우 런타임은 프레젠테이션에 D3DPRESENT_PARAMETERShDeviceWindow 멤버를 사용합니다.

[in] pDirtyRegion

형식: const RGNDATA*

D3DSWAPEFFECT_COPY 사용하여 스왑 체인을 만들지 않는 한 값은 NULL 이어야 합니다. 스왑 체인에 대한 자세한 내용은 Surface 대칭 이동(Direct3D 9) 및D3DSWAPEFFECT를 참조하세요. 이 값이 NULL이 아닌 경우 포함된 영역은 백 버퍼 좌표로 표시됩니다. 영역 내의 사각형은 업데이트해야 하는 최소 픽셀 집합입니다. 이 메서드는 영역 내의 픽셀만 복사하거나 일부 적절하게 확장된 사각형 집합만 복사하여 프레젠테이션을 최적화할 때 이러한 사각형을 고려합니다. 이는 최적화에만 도움이 되며 애플리케이션은 정확히 복사되는 지역에 의존해서는 안 됩니다. 구현은 전체 원본 사각형을 복사하도록 선택할 수 있습니다.

반환 값

형식: HRESULT

가능한 반환 값은 D3D_OK 또는 D3DERR_DEVICEREMOVED( D3DERR 참조)입니다.

설명

필요한 경우 원본 사각형 내의 픽셀을 대상 창의 클라이언트 영역에 있는 대상 사각형으로 전송하기 위해 스트레치 작업이 적용됩니다.

렌더링 대상이 현재 렌더링 대상이 아닌 경우(예: 추가 스왑 체인을 만들 때 가져오는 백 버퍼) BeginScene과 EndScene 쌍 간에 호출되는 경우 D3DERR_INVALIDCALL 반환하지 못합니다. 이는 Direct3D 9의 새로운 동작입니다.

요구 사항

   
대상 플랫폼 Windows
헤더 d3d9.h(D3D9.h 포함)
라이브러리 D3D9.lib

추가 정보

IDirect3DDevice9

분실 디바이스(Direct3D 9)

멀티헤드(Direct3D 9)

Reset