DrvEnableSurface 関数 (winddi.h)

[アーティクル]
03/13/2024

DrvEnableSurface 関数は、描画するサーフェスを設定し、それを特定の物理デバイスに関連付けます。

構文

HSURF DrvEnableSurface(
  DHPDEV dhpdev
);

パラメーター

dhpdev

物理デバイスの PDEV を処理します。これは DrvEnablePDEV の戻り値です。 PDEV は、サーフェスを作成する物理デバイスを記述します。

戻り値

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

注釈

使用するサーフェスを準備する方法は 2 つあります。

このメソッドでは、ドライバーが EngCreateDeviceSurface の呼び出しによってサーフェスを作成することをお勧めします。 GDI がサーフェスを作成し、ドライバーへのハンドルを返した後、ドライバーは EngModifySurface を呼び出します。これにより、適切なフックフラグが設定され、必要に応じて、サーフェスの位置が GDI に通知されます。
2 つ目の方法は、Windows NT 4.0 ドライバーで使用されるメソッドです。このメソッドでは、ドライバーは EngCreateBitmap を呼び出します。この呼び出しの後、ドライバーは EngAssociateSurface を呼び出して、サーフェスを物理ディスプレイデバイスに関連付けます。この GDI 関数を使用すると、ドライバーは、標準形式のビットマップでサポートされているグラフィックス出力ルーチンを指定できます。この関数の呼び出しは、特定の物理デバイスに対してサーフェスが存在しない場合にのみ行うことができます。 Windows 2000 以降のドライバーが、Windows NT 4.0 で実行するようにバックポートされている場合は、このメソッドを使用する必要があります。このようなドライバーが Windows 2000 以降でも実行される場合は、ドライバー内の別のコードパスで最初のメソッドを使用する必要があります。
プリンターデバイスの場合、GDI がグラフィックスを GDI ビットマップに直接収集するのが通常の状況です。ドライバーは EngCreateBitmap を呼び出す必要があります。これにより、GDI はビットマップのメモリを割り当てることができます。

既存の GDI ビットマップハンドルは有効なサーフェスハンドルです。

GDI で管理されるサーフェスを使用するプリンターグラフィックス DLL の場合、 DrvEnableSurface 関数は EngCreateBitmap を呼び出し、物理ページ全体を格納するのに十分な大きさのサーフェスサイズを指定する必要があります。失敗した場合は、呼び出しが成功するまで、サーフェスサイズを小さくして 、EngCreateBitmap の呼び出しを繰り返し試行する必要があります。有効なサイズは EngMarkBandingSurface への入力として指定する必要があります。これにより、サーフェスバンディングが必要であることを GDI に通知します。

DrvEnableSurface がプライマリサーフェスへのハンドルを返した後、そのハンドルで EngModifySurface または EngAssociateSurface を呼び出さないでください。これにより、特定の状況でバグチェックが発生する可能性があります。詳細については、 Microsoft サポート技術情報の記事「330248」を参照してください。

グラフィックスドライバーには DrvEnableSurface が必要です。