CreateCompatibleDC 函式 (wingdi.h)

CreateCompatibleDC 函式會建立與指定裝置相容的記憶體裝置內容 (DC) 。

語法

HDC CreateCompatibleDC(
  [in] HDC hdc
);

[in] hdc

現有DC的句柄。如果此句柄為 NULL，函式會建立與應用程式目前畫面相容的記憶體 DC。

如果函式成功，傳回值就是記憶體DC的句柄。

如果函式失敗，則傳回值為 NULL。

記憶體 DC 只存在於記憶體中。建立記憶體DC時，其顯示介面完全是一個單色圖元寬，一個單色圖元高。應用程式必須先選取正確寬度和高度的點陣圖，應用程式才能使用記憶體DC進行繪圖作業。若要選取DC中的點陣圖，請使用 CreateCompatibleBitmap 函式，指定所需的高度、寬度和色彩組織。

建立記憶體DC時，所有屬性都會設定為一般預設值。記憶體DC可以當做一般DC使用。您可以設定屬性;取得其屬性的目前設定;並選取畫筆、筆刷和區域。

CreateCompatibleDC 函式只能與支援點陣作業的裝置搭配使用。應用程式可以藉由呼叫 GetDeviceCaps 函式來判斷裝置是否支援這些作業。

當您不再需要記憶體 DC 時，請呼叫 DeleteDC 函式。建議您呼叫 DeleteDC 來刪除 DC。不過，您也可以使用 HDC 呼叫 DeleteObject 來刪除 DC。

如果 hdc 為 NULL，則呼叫 CreateCompatibleDC 的線程會擁有所建立的 HDC。當此線程終結時，HDC 已不再有效。因此，如果您建立 HDC 並將它傳遞至另一個線程，則結束第一個線程，第二個線程將無法使用 HDC。

Icm： 如果傳遞至此函式的 DC 已啟用影像色彩管理 (ICM) ，則由函式建立的 DC 已啟用 ICM。來源和目的地色彩空間是在 DC 中指定。

如需範例，請參閱擷取影像。