ホーム › Devices.Display › PFN_DrvStretchBlt

PFN_DrvStretchBlt

コールバック

シグネチャ

BOOL PFN_DrvStretchBlt(
    SURFOBJ* param0,
    SURFOBJ* param1,
    SURFOBJ* param2,
    CLIPOBJ* param3,
    XLATEOBJ* param4,
    COLORADJUSTMENT* param5,
    POINTL* param6,
    RECTL* param7,
    RECTL* param8,
    POINTL* param9,
    DWORD param10
);

パラメーター

フィールド	型
param0	SURFOBJ*
param1	SURFOBJ*
param2	SURFOBJ*
param3	CLIPOBJ*
param4	XLATEOBJ*
param5	COLORADJUSTMENT*
param6	POINTL*
param7	RECTL*
param8	RECTL*
param9	POINTL*
param10	DWORD

公式ドキュメント

DrvStretchBlt 関数は、デバイス管理サーフェスと GDI 管理サーフェスの任意の組み合わせの間で、拡大縮小を伴うビットブロック転送の機能を提供します。

戻り値

関数が成功した場合、戻り値は TRUE です。それ以外の場合は FALSE であり、エラーコードがログに記録されます。

解説(Remarks)

DrvStretchBlt は、特にドライバーがハーフトーン処理を実行できる場合に、デバイスドライバーが GDI ビットマップへ書き込めるようにします。この関数により、GDI ビットマップとデバイスサーフェスに同じハーフトーンアルゴリズムを適用できます。

この関数は、整数倍による拡大縮小など、特定の形式の拡大縮小だけを処理するように実装することもできます。ドライバーがこの呼び出しをフックしていて、サポートしていない操作を要求された場合は、GDI に処理させるためにデータを EngStretchBlt へ転送してください。

ハーフトーン処理を GDI に任せたい場合で、かつ適切な iMode 値を確実に指定したい場合は、ドライバーは DrvStretchBlt をフックし、iMode を HALFTONE に設定したうえで、設定した iMode 値を指定して EngStretchBlt で GDI を呼び出すことができます。

DrvStretchBlt は、ディスプレイドライバーでは省略可能です。

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