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)

Consulte también

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb