EndPage 함수(wingdi.h)

EndPage 함수는 애플리케이션이 페이지에 쓰기를 완료했음을 디바이스에 알 수 있습니다. 이 함수는 일반적으로 디바이스 드라이버가 새 페이지로 이동하도록 지시하는 데 사용됩니다.

구문

int EndPage(
  [in] HDC hdc
);

매개 변수

[in] hdc

인쇄 작업의 디바이스 컨텍스트에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값이 0보다 큽니다.

함수가 실패하면 반환 값은 0보다 작거나 같습니다.

설명

참고 이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현과 같은 런타임 요인(애플리케이션을 작성할 때 예측하기 어려운 요소)에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

 

EndPage 함수를 호출한 후 필요한 경우 ResetDC 함수를 사용하여 디바이스 모드를 변경합니다. ResetDC 호출은 모든 디바이스 컨텍스트 특성을 기본값으로 다시 설정합니다. EndPage와 StartPage 모두 디바이스 컨텍스트 특성을 다시 설정하지 않습니다. 디바이스 컨텍스트 특성은 후속 페이지에서 일정하게 유지됩니다. 다음 페이지를 인쇄하기 전에 개체를 다시 선택하고 매핑 모드를 다시 설정할 필요가 없습니다. 그러나 이렇게 하면 동일한 결과가 생성되고 Windows 버전 간의 코드 차이가 줄어듭니다.

스풀된 파일의 페이지가 약 350MB를 초과하면 인쇄에 실패하고 오류 메시지를 보내지 못할 수 있습니다. 예를 들어 대용량 EMF 파일을 인쇄할 때 발생할 수 있습니다. 페이지 크기 제한은 사용 가능한 가상 메모리 양, 호출 프로세스에 의해 할당된 메모리 양 및 프로세스 힙의 조각화 양을 비롯한 여러 요인에 따라 달라집니다.

예제

이 함수를 사용하는 샘플 프로그램은 방법: GDI 인쇄 API를 사용하여 인쇄를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll

추가 정보

인쇄 스풀러 API 함수

인쇄

ResetDC

StartPage