DrvNextBand 함수(winddi.h)

아티클
03/04/2024

DrvNextBand 함수는 드라이버가 다음 대역을 프린터로 보낼 수 있도록 물리적 페이지에 대한 밴드 그리기를 마쳤을 때 GDI에 의해 호출됩니다.

구문

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

매개 변수

[in] pso

밴딩 표면을 식별하는 SURFOBJ 구조체에 대한 호출자 제공 포인터입니다.

[in] pptl

다음 대역의 함수 제공 원점을 수신하기 위해 POINTL 구조체에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 그렇지 않으면 Win32 SetLastError 함수를 호출하여 오류 코드를 설정한 다음 FALSE를 반환해야 합니다.

설명

프린터 그래픽 DLL이 GDI 관리 표면을 사용하고 표면 밴딩을 지원하는 경우 DrvNextBand 함수를 제공해야 합니다. GDI는 밴드 표면에 포함될 수 있는 페이지 이미지의 부분 그리기를 완료할 때마다 DrvNextBand 를 호출합니다. 그리기 위해 GDI에서 사용하는 표면은 드라이버가 EngMarkBandingSurface를 호출하여 이전에 지정한 표면입니다. 함수는 EngWritePrinter를 호출하여 이미지를 프린터로 보내야 하며 pptl이 가리키는 POINTL 구조에서 다음 대역 원점의 인덱스를 반환해야 합니다.

실제 페이지의 모든 밴드를 그린 후 함수는 pptl 이 가리키는 POINTL 구조체의 두 멤버를 -1로 설정해야 합니다.