PFND3DDDI_DESTROYCONTEXTCB回呼函式 (d3dumddi.h)

pfnDestroyContextCb 函式會終結透過 pfnCreateContextCb 函式呼叫所建立的內容。

語法

PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;

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

參數

hDevice

顯示裝置 (的句柄,也就是圖形內容) 。

unnamedParam2

pData [in]

包含要終結之內容的句柄 之D3DDDICB_DESTROYCONTEXT 結構的指標。

傳回值

pfnDestroyContextCb 會傳回下列其中一個值:

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

此函式也可能傳回其他 HRESULT 值。

備註

如果指定的內容尚未完成目前排入佇列的工作, 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 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3dumddi.h (include D3dumddi.h)

另請參閱

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb