PFN_DrvLineTo

コールバック

シグネチャ

BOOL PFN_DrvLineTo(
    SURFOBJ* param0,
    CLIPOBJ* param1,
    BRUSHOBJ* param2,
    INT param3,
    INT param4,
    INT param5,
    INT param6,
    RECTL* param7,
    DWORD param8
);

パラメーター

フィールド	型
param0	SURFOBJ*
param1	CLIPOBJ*
param2	BRUSHOBJ*
param3	INT
param4	INT
param5	INT
param6	INT
param7	RECTL*
param8	DWORD

公式ドキュメント

DrvLineTo 関数は、単一の実線で整数座標のみのコスメティックラインを描画します。

戻り値

DrvLineTo は、成功した場合は TRUE を返します。それ以外の場合は FALSE を返します。

解説(Remarks)

DrvLineTo は、Win32 の LineTo 関数に対するアプリケーションからの呼び出しを最適化するために、ドライバーが提供できる省略可能なエントリポイントです。ドライバーが DrvLineTo をフックしていない場合、またはドライバーがこの関数の呼び出しに対して FALSE を返した場合、GDI は代わりに DrvStrokePath を自動的に呼び出します。DrvLineTo をフックしたドライバーは、描画先のサーフェスが DIB である場合に EngLineTo を呼び出すことができます。

この関数は、整数の端点と実線のコスメティックラインのみをサポートするため、DrvStrokePath よりも単純です。GDI は、DrvStrokePath ではなく DrvLineTo を呼び出す場合、オーバーヘッドが小さくなります。そのため DrvLineTo は、公称幅の線をハードウェアで高速化できるドライバーが、単純な最適化として使用することを想定しています。

ミックスモードは、入力されるパターンをデバイスサーフェス上に既に存在するデータとどのように混合するかを定義します。MIX データ型は、2 つのバイナリラスターオペレーション (ROP2) の値を 1 つの ULONG にパックしたものです。最下位バイトは前景のラスターオペレーションを定義し、その次のバイトは背景のラスターオペレーションを定義します。ラスターオペレーションコードの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

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