EngCreateDeviceSurface

EngCreateDeviceSurface 関数は、ドライバが管理するデバイスサーフェスを作成し、そのハンドルを返す。

EngCreateDeviceSurface dhsurf, sizl, iFormatCompat

dhsurf : [intptr] デバイスが管理するサーフェスへのデバイスハンドル。このハンドルは、入出力のために SURFOBJ 構造体が渡されるときにドライバへ渡される。
sizl : [var] 作成するサーフェスの幅と高さを含む SIZEL 構造体を指定する。この構造体の cx, cy メンバはそれぞれサーフェスの幅と高さ（ピクセル単位）を含む。SIZEL 構造体は SIZE 構造体と同一である。
iFormatCompat : [int] 作成するデバイスサーフェスの互換エンジンフォーマットを指定する。これは GDI が複雑な描画呼び出しをシミュレートするのに一時バッファが必要な場合に使われる。

(プラグイン / モジュール : gdi32.dll)

解説

EngCreateDeviceSurface 関数は、ドライバが管理するデバイスサーフェスを作成し、そのハンドルを返す。

[戻り値]
関数が成功した場合、戻り値はサーフェスを識別するハンドルとなる。それ以外の場合はゼロとなり、エラーコードがログに記録される。

[備考]
サーフェスのストレージ領域はドライバが任意に提供できる。サーフェスは EngAssociateSurface
を使って関連付けるべきである。サーフェスが不要になったら EngDeleteSurface を使って削除する。

情報