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 版開始呼叫
下列程式代碼範例示範如何終結顯示裝置的默認內容。
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) |