DrvStartBanding 関数 (winddi.h)

  • [アーティクル]

DrvStartBanding 関数は、レンダリングのために物理ページのバンドの送信を開始する準備ができたら、GDI によって呼び出されます。

構文

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

パラメーター

[in] pso

バンディング サーフェスを識別する SURFOBJ 構造体への呼び出し元提供のポインター。

[in] pptl

POINTL 構造体への呼び出し元指定ポインター。最初のバンドの関数提供の原点を受け取ります。

戻り値

操作が成功した場合、関数は TRUE を返す必要があります。 それ以外の場合は、Win32 SetLastError 関数を呼び出してエラー コードを設定し、 FALSE を返す必要があります。

注釈

プリンター グラフィックス DLL が GDI で管理されたサーフェスを使用し、サーフェス バンディングをサポートしている場合は、 DrvNextBand 関数を提供する必要があります。 GDI は、プリンター グラフィックス DLL の DrvEnableSurface 関数が以前に EngMarkBandingSurface と呼ばれた場合にのみ、DrvStartBanding を呼び出してバンディングサーフェスを指定します。

DrvStartBanding 関数の目的は、プリンター グラフィックス DLL が物理ページでバンディング操作を開始する前に必要な初期化を実行し、最初のバンドの原点のインデックスを GDI に提供できるようにすることです。

DrvStartBanding 関数は、ページごとに 1 回呼び出されます。 GDI がバンドの描画を完了するたびに、ドライバーがプリンターにバンドを送信できるように 、DrvNextBand を呼び出します。

要件

要件 値
対象プラットフォーム デスクトップ
Header winddi.h (Winddi.h を含む)

こちらもご覧ください

DrvEnableSurface

DrvNextBand

EngMarkBandingSurface