DrvNextBand 関数 (winddi.h)

[アーティクル]
03/13/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 に設定する必要があります。