NtGdiDdGetDC 関数

  • [アーティクル]

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

指定したサーフェスのデバイス コンテキスト (DC) を作成します。

構文

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

パラメーター

hSurface [in]

以前に NtGdiDdCreateSurface または NtGdiDdCreateSurfaceObject によって返されたカーネル モードの DirectDraw サーフェスにハンドルします。

puColorTable [in]

返された DC のオーバーライド カラー テーブルへのポインター。

戻り値

成功した場合、この関数は有効な HDC を返します。それ以外の場合は NULL を返します。

解説

特定の時点で、サーフェスごとに許可される DC は 1 つだけです。 NtGdiDdGetDC への後続の呼び出しは、前の DC が解放されるまで失敗します。

アプリケーションでは、代わりに IDirectDrawSurface7::GetDC を呼び出すようにお勧めします。これは、オペレーティング システムに依存しない方法で同じ機能を提供します。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Ntgdi.h

関連項目

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

DdGetDC