DrvDeriveSurface 関数 (winddi.h)
DrvDeriveSurface 関数は、指定した DirectDraw サーフェイスから GDI サーフェスを派生させます。
構文
HBITMAP DrvDeriveSurface(
DD_DIRECTDRAW_GLOBAL *pDirectDraw,
DD_SURFACE_LOCAL *pSurface
);
パラメーター
pDirectDraw
DirectDraw オブジェクトを記述する DD_DIRECTDRAW_GLOBAL 構造体へのポインター。
pSurface
GDI サーフェスをラップする DirectDraw サーフェスを記述する DD_SURFACE_LOCAL 構造体へのポインター。
戻り値
DrvDeriveSurface は 、成功した場合に派生 GDI サーフェスへのハンドルを返します。 呼び出しが失敗した場合、またはドライバーが指定された DirectDraw サーフェイスへの GDI 描画を高速化できない場合は 、NULL を 返します。
注釈
DrvDeriveSurface を使用すると、ドライバーは、DirectDraw ビデオ メモリまたは AGP サーフェス オブジェクトの周囲にラップされた GDI サーフェスを作成して、サーフェスへの高速 GDI 描画を可能にします。 ドライバーがこの呼び出しをフックしない場合、DirectDraw サーフェスへのすべての GDI 描画は、DIB エンジンを使用してソフトウェアで行われます。
GDI は、RGB サーフェスのみを使用して DrvDeriveSurface を呼び出します。
ドライバーは DrvCreateDeviceBitmap を呼び出して、DirectDraw サーフェイスと同じサイズと形式の GDI サーフェスを作成する必要があります。 既に存在するため、実際のピクセルの領域を割り当てる必要はありません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | winddi.h (Winddi.h を含む) |