DdCreateSurfaceObject 関数 (ddrawgdi.h)

  • [アーティクル]

[この機能は、オペレーティング システムのリビジョンごとに変更される場合があります。 代わりに、Microsoft DirectDraw と Microsoft Direct3DAPIs を使用します。これらの API は、このようなオペレーティング システムの変更からアプリケーションを保護し、ディスプレイ ドライバーと直接やり取りすることに関連する他の多くの困難を隠します。

NtGdiDdCreateSurfaceObject 関数のラッパーで、カーネル モードのサーフェス オブジェクトを作成します。

GdiEntry4 は、この関数のエイリアスとして定義されます。

構文

BOOL DdCreateSurfaceObject(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  BOOL                      bPrimarySurface
);

パラメーター

pSurfaceLocal

ユーザー モードサーフェスオブジェクトへのポインター。 詳細については、DDK のドキュメントを参照してください。 カーネル モード オブジェクトへのハンドルは pSurfaceLocal-hDDSurface> に配置されます。

bPrimarySurface

予約済み。

戻り値

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

解説

この関数は、システム メモリ サーフェスを表すオブジェクトを作成するために使用されます。 ビデオ メモリ サーフェスには、 NtGdiDdCreateSurfaceObject 呼び出しの暗黙的な部分としてカーネル モード表現が与えられます。

アプリケーションでは、DirectDraw API と Direct3D API を使用してグラフィックス デバイス オブジェクトを作成および管理することをお勧めします。 これらのコンストラクトは、簡略化されたオペレーティング システムに依存しない方法でデバイス作成プロセスを抽象化します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ddrawgdi.h

関連項目

グラフィックスの低レベルクライアントサポート