共用方式為


PFND3DDDI_DESTROYCONTEXTCB回呼函式 (d3dumddi.h)

D3D 運行時間的 pfnDestroyContextCb 函式會終結透過呼叫 pfnCreateContextCb 函式所建立的內容。

語法

PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;

HRESULT Pfnd3dddiDestroycontextcb(
  HANDLE hDevice,
  const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}

參數

hDevice

[in]處理顯示裝置(也就是圖形內容)。

unnamedParam2

[in]識別要終結之內容的 D3DDDICB_DESTROYCONTEXT 結構的指標。

傳回值

pfnDestroyContextCb 會傳回 HRESULT,指出內容刪除要求的成功或失敗。 常見的傳回值包括:

傳回碼 描述
S_OK 已成功終結內容。
E_INVALIDARG 已驗證參數,並判斷為不正確。

言論

如果指定的內容尚未完成目前排入佇列的工作,pfnDestroyContextCb 函式會封鎖,直到內容完成其工作,然後傳回。

如果內容終結目前擁有同步處理物件,pfnDestroyContextCb 會傳回錯誤。

如需驅動程式如何從 Direct3D 第 11 版開始呼叫 pfnDestroyContextCb 的相關信息,請參閱從 Direct3D 10變更。

下列程式代碼範例示範如何終結顯示裝置的默認內容。

    if (m_d3dCallbacks.pfnDestroyContextCb) {
        D3DDDICB_DESTROYCONTEXT DestroyContext;
        DestroyContext.hContext = m_sContexts[MULTI_ENGINE_NODE_3D].hContext;
        m_d3dCallbacks.pfnDestroyContextCb(m_hD3D, &DestroyContext);
        m_sContexts[MULTI_ENGINE_NODE_3D].hContext = NULL;
    }

要求

要求 價值
最低支援的用戶端 Windows Vista (WDDM 1.0)
目標平臺 桌面
標頭 d3dumddi.h (包括 D3dumddi.h)

另請參閱

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb