Win32 API 日本語リファレンス
ホーム › Devices.Display › PFN_DrvStartBanding

PFN_DrvStartBanding

コールバック

シグネチャ

BOOL PFN_DrvStartBanding(
    SURFOBJ* param0,
    POINTL* ppointl
);

パラメーター

フィールド型
param0SURFOBJ*
ppointlPOINTL*

公式ドキュメント

DrvStartBanding 関数は、物理ページのバンドをドライバーへ送信してレンダリングさせる準備が整ったときに、GDI から呼び出されます。

戻り値

操作が成功した場合、この関数は TRUE を返します。失敗した場合は、Win32 の SetLastError 関数を呼び出してエラーコードを設定し、FALSE を返します。

解説(Remarks)

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

DrvStartBanding 関数の役割は、物理ページに対するバンディング処理を開始する前に必要な初期化をプリンターグラフィックス DLL が実行できるようにすること、および最初のバンドの原点のインデックスを GDI に渡すことです。

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)