NtGdiD3DCoNtextCreate 函式

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

建立內容。

語法

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

參數

hDirectDrawLocal [in]

處理核心模式 DirectDraw 物件,先前使用 NtGdiDdCreateDirectDrawObject建立,代表要建立 Direct3D 內容的裝置。

hSurfColor [in]

DD_SURFACE_LOCAL 結構的句 柄,描述要當做轉譯目標的 DirectDraw 表面。

hSurfZ [in]

DD_SURFACE_LOCAL 結構的句 柄,描述要當做深度緩衝區使用的 DirectDraw 表面。 如果此成員為 Null,則不會執行深度緩衝。

pdcci [in, out]

D3DNTHAL_CONTEXTCREATEDATA結構的指標,其中包含建立內容所需的資訊,以及驅動程式應該儲存在新內容中的資料。

傳回值

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

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

 

規格需求

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

另請參閱

圖形低階用戶端支援