CreateCompatibleDC 関数 (wingdi.h)

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 で指定されます。

例

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

要件

こちらもご覧ください

CreateCompatibleBitmap

DeleteDC

デバイス コンテキスト関数

デバイス コンテキストの概要

GetDeviceCaps