DdGetDC 函式 (ddrawgdi.h)

[此函式可能會隨著每個作業系統修訂而變更。 請改用 DirectDraw 和 Microsoft Direct3DAPIs;這些 API 會將應用程式與這類作業系統變更隔離,並隱藏與顯示驅動程式直接互動的許多其他困難。

NtGdiDdGetDC 函式的包裝函式,並傳回代表所指出 Microsoft DirectDraw 表面的 Windows Graphics Device Interface (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 必須由 NtGdiDdReleaseDCGdiEntry8 的呼叫釋放。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ddrawgdi.h

另請參閱

圖形低階客戶端支援