DdGetDC 関数 (ddrawgdi.h)
[この機能は、オペレーティング システムのリビジョンごとに変更される可能性があります。 代わりに、DirectDraw と Microsoft Direct3DAPIs を使用します。これらの API は、このようなオペレーティング システムの変更からアプリケーションを保護し、ディスプレイ ドライバーとの直接対話に関連する他の多くの困難を隠します。
NtGdiDdGetDC 関数のラッパー。指定された Microsoft DirectDraw サーフェスを表す Windows グラフィックス デバイス インターフェイス (GDI) デバイス コンテキスト (DC) を返します。
GdiEntry7 は、この関数のエイリアスとして定義されています。
構文
HDC DdGetDC(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
LPPALETTEENTRY pColorTable
);
パラメーター
pSurfaceLocal
DC が要求される DirectDraw サーフェスへのポインター。
pColorTable
PALETTEENTRY 構造体の 256 エントリ配列へのオプションのポインター。 カラー テーブルが null で、サーフェスと表示モードの両方がピクセルあたり 8 ビットの場合、DC はデバイスのカラー テーブルを共有します。
戻り値
成功した場合、この関数は有効な HDC を返します。それ以外の場合は NULL を返します。
注釈
サーフェスと現在の表示モードの両方がピクセルあたり 8 ビットでパレット化されている場合、DC には、そのカラー テーブルがディスプレイ デバイスのカラー テーブルによって共有される特別なプロパティを指定できます。 アプリケーションでは、代わりに IDirectDrawSurface7::GetDC を呼び出すようにお勧めします。これにより、オペレーティング システムに依存しない方法で同じ機能が提供されます。
返される DC は、 NtGdiDdReleaseDC または GdiEntry8 の呼び出しによって解放される必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ddrawgdi.h |