共用方式為

LPD3DHAL_CONTEXTCREATECB回呼函式 （d3dhal.h）

  • 發行項

D3dContextCreate 函式會建立內容。

語法

LPD3DHAL_CONTEXTCREATECB Lpd3dhalContextcreatecb;

DWORD Lpd3dhalContextcreatecb(
  LPD3DHAL_CONTEXTCREATEDATA unnamedParam1
)
{...}

參數

unnamedParam1

pccd [in]

指向 D3DHAL_CONTEXTCREATEDATA 結構，其中包含建立內容所需的資訊，以及驅動程式應該儲存在新內容中的數據。

傳回值

D3dContextCreate 會傳回下列其中一個回呼碼：

言論

D3dContextCreate 必須在支援 Microsoft Direct3D 的驅動程式中實作。 它應該執行下列步驟：

  • 使用驅動程式執行轉譯所需的所有資訊，初始化驅動程序的內容。 這包括將轉譯目標和深度緩衝區建立關聯，lpDDSLcl 和 lpDDSZLclpccd 指向內容之D3DHAL_CONTEXTCREATEDATA結構的成員。
  • 產生這個新內容的唯一內容標識符，並在 D3DHAL_CONTEXTCREATEDATA 的 dwhContext 成員中傳回它。 Direct3D 會在對這個 Direct3D 裝置進行的每個後續回呼中使用此內容識別碼。 驅動程序絕對不能建立零的內容句柄。
  • 將 ddrval 成員D3DHAL_CONTEXTCREATEDATA設定為成功時DD_OK，並在無法建立內容時D3DHAL_OUTOFCONTEXTS。
  • 傳回DDHAL_DRIVER_HANDLED。
D3dContextCreate 不應該快取傳入為 D3DHAL_CONTEXTCREATEDATA lpDDLcl 成員之 DD_DIRECTDRAW_LOCAL 結構的指標。 如果驅動程式後續需要透過此DD_DIRECTDRAW_LOCAL指標存取的任何資訊，驅動程式應該將資訊儲存在驅動程式的私人內容數據結構中。

狀態不會在內容之間共用;因此，驅動程式必須維護每個內容的完整狀態資訊。 任何後續呼叫 D3dDrawPrimitives2會變更此狀態。

驅動程式必須能夠參考內容內建立的所有紋理句柄。 然後，當發出 D3dContextDestroy 呼叫時，驅動程式就可以清除與此內容中建立之紋理相關的所有驅動程式特定數據。

D3dContextCreate 可以使用停用 PDEV呼叫。 呼叫顯示器驅動程式的 DrvAssertMode 函式來停用或啟用 PDEV。 如需詳細資訊，請參閱 管理 PDEV。

要求

要求 價值
目標平臺 桌面
標頭 d3dhal.h （包括 D3dhal.h）

另請參閱

D3DHAL_CONTEXTCREATEDATA

D3dContextDestroy

D3dDrawPrimitives2

DD_DIRECTDRAW_LOCAL