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 |