DdGetDxHandle 関数 (ddrawgdi.h)

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

DirectX API メカニズムを制御するカーネル モード エントリ ポイントの後続の呼び出しで使用するカーネル モードの Microsoft DirectX API ハンドルを返します。

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

構文

HANDLE DdGetDxHandle(
  [in] LPDDRAWI_DIRECTDRAW_LCL   pDDraw,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  [in] BOOL                      bRelease
);

パラメーター

[in] pDDraw

サーフェスを所有する DirectDraw オブジェクトへのポインター。 このパラメーターは省略可能であり、 NULL に設定できます。

[in] pSurface

カーネル モードの DirectX API ハンドルを返すサーフェスへのポインター。 このパラメーターは省略可能であり、 NULL に設定できます。

[in] bRelease

DirectX API カーネル モード インターフェイスを解放する必要がある場合は TRUE に 設定します。 それ以外の場合は FALSE。

戻り値

後続の DirectX API 指向カーネル エントリ ポイントで使用される DirectX API ハンドル。

解説

pDDraw と pSurface の両方を指定した場合、pSurface は無視されます。

要件

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

関連項目

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