CreateCompatibleDC 関数 (wingdi.h)

[アーティクル]
08/27/2023

CreateCompatibleDC 関数は、指定したデバイスと互換性のあるメモリデバイスコンテキスト (DC) を作成します。

構文

HDC CreateCompatibleDC(
  [in] HDC hdc
);

パラメーター

[in] hdc

既存の DC へのハンドル。このハンドルが NULL の場合、関数はアプリケーションの現在の画面と互換性のあるメモリ DC を作成します。

戻り値

関数が成功した場合、戻り値はメモリ DC へのハンドルです。

関数が失敗した場合は、返される値は NULL です。

注釈

メモリ DC はメモリ内にのみ存在します。メモリDCが作成されると、その表示面は、ちょうど1つのモノクロピクセル幅と1つのモノクロピクセルの高さである。アプリケーションは、描画操作にメモリ DC を使用する前に、DC に正しい幅と高さのビットマップを選択する必要があります。 DC にビットマップを選択するには、CreateCompatibleBitmap 関数を使用して、必要な高さ、幅、色organization指定します。

メモリ DC が作成されると、すべての属性が通常の既定値に設定されます。メモリ DC は、通常の DC として使用できます。属性を設定できます。その属性の現在の設定を取得します。ペン、ブラシ、および領域を選択します。

CreateCompatibleDC 関数は、ラスター操作をサポートするデバイスでのみ使用できます。アプリケーションは、 GetDeviceCaps 関数を呼び出すことによって、デバイスがこれらの操作をサポートしているかどうかを判断できます。

メモリ DC が不要になったら、 DeleteDC 関数を呼び出します。 DELETEDC を呼び出して DC を削除することをお勧めします。ただし、HDC で DeleteObject を呼び出して DC を削除することもできます。

hdc が NULL の場合、CreateCompatibleDC を呼び出すスレッドは、作成された HDC を所有します。このスレッドが破棄されると、HDC は無効になります。したがって、HDC を作成して別のスレッドに渡した後、最初のスレッドを終了すると、2 番目のスレッドは HDC を使用できなくなります。

Icm： この関数に渡される DC がイメージカラー管理 (ICM) に対して有効になっている場合、その関数によって作成された DC は ICM 対応です。ソースと変換先の色空間は、DC で指定されます。

例

例については、「イメージのキャプチャ」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll