PFND3DDDI_DESTROYCONTEXTCB funzione di callback (d3dumddi.h)

  • Articolo

La funzione pfnDestroyContextCb elimina definitivamente il contesto creato tramite una chiamata alla funzione pfnCreateContextCb .

Sintassi

PFND3DDDI_DESTROYCONTEXTCB Pfnd3dddiDestroycontextcb;

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

Parametri

hDevice

Handle per un dispositivo di visualizzazione, ovvero il contesto grafico.

unnamedParam2

pData [in]

Puntatore a una struttura D3DDDICB_DESTROYCONTEXT che contiene un handle per il contesto da eliminare.

Valore restituito

pfnDestroyContextCb restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK Il contesto è stato eliminato correttamente.
E_INVALIDARG I parametri sono stati convalidati e sono stati determinati come non corretti.

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

Se il contesto specificato non ha completato il lavoro attualmente accodato, la funzione pfnDestroyContextCb si blocca fino al completamento del lavoro del contesto e quindi restituisce.

pfnDestroyContextCb restituisce un errore se il contesto da eliminare è attualmente proprietario di un oggetto di sincronizzazione.

Nota direct3D versione 11: Per altre informazioni su come il driver chiama pfnDestroyContextCb, vedere Modifiche da Direct3D 10.

Nell'esempio di codice seguente viene illustrato come eliminare definitivamente il contesto predefinito per un dispositivo di visualizzazione.

    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;
    }

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDICB_DESTROYCONTEXT

pfnCreateContextCb