GdiEndPageEMF 함수(winppi.h)

아티클
03/05/2024

GdiEndPageEMF 함수는 EMF 형식 인쇄 작업의 실제 페이지에 대한 EMF 재생 작업을 종료합니다.

구문

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

매개 변수

SpoolFileHandle

GdiGetSpoolFileHandle에 대한 이전 호출에서 가져온 호출자 제공 스풀 파일 핸들입니다.

dwOptimization

호출자가 제공한 플래그입니다. 다음 플래그가 정의됩니다.

EMF_PP_COLOR_OPTIMIZATION

색 최적화를 사용하도록 설정합니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

작업이 성공하면 함수는 TRUE를 반환 합니다. 그렇지 않으면 함수가 FALSE를 반환하고 GetLastError를 호출하여 오류 코드를 가져올 수 있습니다.

설명

GdiEndPageEMF 함수는 인쇄 프로세서의 PrintDocumentOnPrintProcessor 함수 내에서 사용하기 위해 gdi32.dll 의해 내보내집니다.

GdiEndPageEMF 함수는 실제 페이지의 처리를 종료하고 프린터에서 꺼내게 합니다. 인쇄 프로세서는 다음 시간에 GdiEndPageEMF 를 호출해야 합니다.

GdiPlayPageEMF를 호출하여 실제 페이지에 적절한 수의 문서 페이지를 배치한 후 GdiPlayPageEMF는 실제로 디바이스 컨텍스트에서 인쇄되지 않고 실제 페이지에 인쇄할 텍스트와 그래픽을 설명하는 데이터 구조를 준비합니다. GdiEndPageEMF가 호출될 때 텍스트와 그래픽이 디바이스 컨텍스트에 인쇄됩니다.
GdiGetDevmodeForPage를 호출할 때마다 문서 페이지의 DEVMODEW 구조가 이전 페이지의 DEVMODE 구조와 다르다는 것을 나타냅니다.

dwOptimization 매개 변수를 EMF_PP_COLOR_OPTIMIZATION 로 설정하여 이 함수를 호출하면 색 최적화가 사용됩니다. dwOptimization을 0으로 설정하면 최적화가 수행되지 않습니다. 색 최적화를 사용하도록 설정하면 스풀 파일에 색이 있으면 스풀 파일이 색으로 재생됩니다. 스풀 파일에 색이 없으면 스풀 파일이 단색으로 재생됩니다.

색 워터마크를 생성하기 위해 Unidrv 렌더링 플러그 인을 만드는 경우 색 최적화로 인해 흑백 문서에 인쇄될 때 색 워터마크가 흑백으로 인쇄되는 것이 좋습니다. 색 워터마크가 색 및 흑백 문서로 올바르게 인쇄되도록 하려면 색 최적화를 사용하지 않도록 설정합니다.

dwOptimization 매개 변수로 제어되는 색 최적화는 ATTRIBUTE_INFO_2 또는 ATTRIBUTE_INFO_3 구조체의 dwColorOptimization 멤버를 설정하여 제어할 수도 있습니다. 이 최적화는 Unidrv *ChangeColorModeOnDoc? 색 특성으로도 제어할 수 있습니다(색 특성 참조).

자세한 내용은 인쇄 프로세서에서 GDI 함수 사용을 참조하세요.