PFND3DDDI_DESTROYCONTEXTCB - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dumddi.h
PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;
HRESULT Pfnd3dddiDestroycontextcb(
HANDLE hDevice,
const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The D3D runtime's pfnDestroyContextCb function destroys a context that was created through a call to its pfnCreateContextCb function.
hDevice[in] Handle to a display device (that is, the graphics context).
unnamedParam2[in] Pointer to a D3DDDICB_DESTROYCONTEXT structure that identifies the context to destroy.
pfnDestroyContextCb returns an HRESULT to indicate the success or failure of the context deletion request. Common return values include:
| Return code | Description |
|---|---|
| S_OK | The context was successfully destroyed. |
| E_INVALIDARG | Parameters were validated and determined to be incorrect. |
If the specified context has not finished the work that is currently queued to it, the pfnDestroyContextCb function blocks until the context finishes its work and then returns.
pfnDestroyContextCb returns an error if the context to destroy currently owns a synchronization object.
For information about how the driver calls pfnDestroyContextCb starting in Direct3D version 11, see Changes from Direct3D 10.
The following code example shows how to destroy the default context for a display device.
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;
}