PFND3DDDI_DESTROYCONTEXTCB función de devolución de llamada (d3dumddi.h)
La función pfnDestroyContextCb de D3D destruye un contexto que se creó a través de una llamada a su función de pfnCreateContextCb.
Sintaxis
PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;
HRESULT Pfnd3dddiDestroycontextcb(
HANDLE hDevice,
const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}
Parámetros
hDevice
[in] Controla un dispositivo de visualización (es decir, el contexto de gráficos).
unnamedParam2
[in] Puntero a una estructura D3DDDICB_DESTROYCONTEXT que identifica el contexto que se va a destruir.
Valor devuelto
pfnDestroyContextCb devuelve un VALOR HRESULT para indicar el éxito o error de la solicitud de eliminación de contexto. Entre los valores devueltos comunes se incluyen:
| Código devuelto | Descripción |
|---|---|
| S_OK | El contexto se destruyó correctamente. |
| E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
Observaciones
Si el contexto especificado no ha finalizado el trabajo que está actualmente en cola, el pfnDestroyContextCb función se bloquea hasta que el contexto finaliza su trabajo y, a continuación, devuelve.
pfnDestroyContextCb devuelve un error si el contexto para destruir actualmente posee un objeto de sincronización.
Para obtener información sobre cómo el controlador llama a pfnDestroyContextCb a partir de la versión 11 de Direct3D, consulte Cambios de Direct3D 10.
En el ejemplo de código siguiente se muestra cómo destruir el contexto predeterminado de un dispositivo para mostrar.
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;
}
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista (WDDM 1.0) |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
d3dumddi.h (incluya D3dumddi.h) |