PFND3DDDI_DESTROYCONTEXTCB funzione di callback (d3dumddi.h)
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) |