次の方法で共有

DrvQueryPerBandInfo 関数 (winddi.h)

  • [アーティクル]

プリンター グラフィックス DLL の DrvQueryPerBandInfo 関数は、ドライバーが GDI にバンド固有の情報を提供できるように、物理ページのバンドの描画を開始する前に GDI によって呼び出されます。

構文

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

パラメーター

[in] pso

描画サーフェイスを記述する SURFOBJ 構造体への呼び出し元指定のポインター。

[in, out] pbi

関数が上書きできる既定の情報を含む PERBANDINFO 構造体への呼び出し元指定のポインター。

戻り値

関数は、次のいずれかの値を返す必要があります。

リターン コード 説明
0 より大きい値
 GDI は PERBANDINFO 構造体の内容を使用します。
Zero
 GDI は PERBANDINFO 構造体の内容を無視します。
DDI_ERROR
 GDI はバンドを描画しません。

解説

プリンター グラフィックス DLL で GDI で管理されるサーフェスが使用され、サーフェス バンディングがサポートされている場合は、必要に応じて DrvQueryPerBandInfo 関数を提供できます。 GDI は、各バンドをレンダリングする前に 関数を呼び出します。

プリンター グラフィックス DLL では、関数の PERBANDINFO 構造体を使用して、前のバンドを再描画するかどうかを示し、バンドをスケーリングするように指定します。 プリンター グラフィックス DLL がバンディングをサポートしていても 、DrvQueryPerBandInfo 関数を提供しない場合、GDI はバンドを繰り返したりスケールしたりしません。

DrvQueryPerBandInfo 関数は、EMF ファイルの再生中にのみ呼び出されます。

要件

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

関連項目

DrvNextBand

DrvStartBanding