NtGdiDdCreateSurfaceEx 函式

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

從 Microsoft DirectDraw 介面建立 Microsoft Direct3D 介面，並將要求的控制碼值與其產生關聯。

語法

DWORD APIENTRY NtGdiDdCreateSurfaceEx(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ DWORD  dwSurfaceHandle
);

hDirectDraw [in]: 處理應用程式所建立的 DirectDraw 物件。
hSurface [in]: 要為 Direct3D 建立之 DirectDraw 表面的控制碼。這些控制碼在每個不同的 DD_DIRECTDRAW_LOCAL 結構中都是唯一的。
dwSurfaceHandle [in]: 處理 DD_CREATESURFACEEXDATA結構， 其中包含驅動程式建立介面所需的資訊。

NtGdiDdCreateSurfaceEx 會傳回下列其中一個回呼代碼。

傳回碼	描述
DDHAL_DRIVER_HANDLED	驅動程式已執行作業，並傳回該作業的有效傳回碼。如果此程式碼DD_OK，DirectDraw 或 Direct3D 會繼續進行函式。否則，DirectDraw 或 Direct3D 會傳回驅動程式所提供的錯誤碼，並中止函式。
DDHAL_DRIVER_NOTHANDLED	驅動程式對要求的作業沒有批註。如果需要驅動程式實作特定的回呼，DirectDraw 或 Direct3D 會報告錯誤狀況。否則，DirectDraw 或 Direct3D 會處理作業，就像執行 DirectDraw 或 Direct3D 裝置無關實作來定義驅動程式回呼一樣。