DrvNextBand 函式 (winddi.h)

發行項
03/04/2024

當DrvNextBand函式完成繪製實體頁面的訊號時，GDI會呼叫DrvNextBand函式，讓驅動程式可以將下一個帶狀線傳送至列印機。

語法

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。