PFND3DDDI_DESTROYCONTEXTCB función de devolución de llamada (d3dumddi.h)
La función pfnDestroyContextCb destruye el contexto que se creó a través de una llamada a la función pfnCreateContextCb .
Sintaxis
PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;
HRESULT Pfnd3dddiDestroycontextcb(
HANDLE hDevice,
const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador de un dispositivo de visualización (es decir, el contexto de gráficos).
unnamedParam2
pData [in]
Puntero a una estructura D3DDDICB_DESTROYCONTEXT que contiene un identificador para el contexto que se va a destruir.
Valor devuelto
pfnDestroyContextCb devuelve uno de los siguientes valores:
Código devuelto | Descripción |
---|---|
S_OK | El contexto se destruyó correctamente. |
E_INVALIDARG | Los parámetros se validaron y determinaron que son incorrectos. |
Esta función también podría devolver otros valores HRESULT.
Comentarios
Si el contexto especificado no ha finalizado el trabajo que está actualmente en cola, la función pfnDestroyContextCb 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.
Nota de Direct3D versión 11: Para obtener más información sobre cómo el controlador llama a pfnDestroyContextCb, consulta 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 | Value |
---|---|
Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Plataforma de destino | Escritorio |
Encabezado | d3dumddi.h (incluya D3dumddi.h) |