EngCreateDeviceSurface 関数 (winddi.h)

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

構文

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

[in] dhsurf

デバイスによって管理されるサーフェスへのデバイスハンドル。このハンドルは、入力または出力用に SURFOBJ 構造体が渡されるときにドライバーに渡されます。

[in] sizl

作成するサーフェスの幅と高さを含む SIZEL 構造体を指定します。この構造体の cx メンバーと cy メンバーには、それぞれ、サーフェスの幅と高さがピクセル単位で含まれます。 SIZEL 構造体は、 SIZE 構造体と同じです。

iFormatCompat

作成するデバイスサーフェイスの互換性のあるエンジン形式を指定します。これは、複雑な描画呼び出しをシミュレートするために一時的なバッファーが必要な場合に GDI によって使用されます。

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

必要に応じて、ドライバーによってサーフェスの記憶域を提供できます。サーフェスは EngAssociateSurface を使用して関連付ける必要があります。サーフェスは、 EngDeleteSurface を使用して不要になったときに削除する必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	winddi.h (Winddi.h を含む)
Library	Win32k.lib
[DLL]	Win32k.sys