PFND3DDDI_DESTROYCONTEXTCB função de retorno de chamada (d3dumddi.h)

Artigo
12/21/2024

A função pfnDestroyContextCb do runtime D3D destrói um contexto criado por meio de uma chamada para sua função de pfnCreateContextCb .

Sintaxe

PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;

HRESULT Pfnd3dddiDestroycontextcb(
  HANDLE hDevice,
  const D3DDDICB_DESTROYCONTEXT *unnamedParam2
)
{...}

Parâmetros

hDevice

[in] Manipule para um dispositivo de exibição (ou seja, o contexto gráfico).

unnamedParam2

[in] Ponteiro para uma estrutura D3DDDICB_DESTROYCONTEXT que identifica o contexto a ser destruído.

Valor de retorno

pfnDestroyContextCb retorna um HRESULT para indicar o êxito ou falha da solicitação de exclusão de contexto. Os valores de retorno comuns incluem:

Código de retorno	Descrição
S_OK	O contexto foi destruído com êxito.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.

Observações

Se o contexto especificado não tiver concluído o trabalho que está na fila no momento, o pfnDestroyContextCb blocos de função até que o contexto conclua seu trabalho e retorne.

pfnDestroyContextCb retornará um erro se o contexto para destruir atualmente possuir um objeto de sincronização.

Para obter informações sobre como o driver chama pfnDestroyContextCb começando no Direct3D versão 11, consulte Alterações do Direct3D 10.

O exemplo de código a seguir mostra como destruir o contexto padrão para um dispositivo de exibição.

    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
de cliente com suporte mínimo	Windows Vista (WDDM 1.0)
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Consulte também

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb

Compartilhar via