共用方式為

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

另請參閱

圖形低階用戶端支援