PFND3DDDI_ESCAPECB funzione di callback (d3dumddi.h)

La funzione di callback pfnEscapeCb condivide le informazioni con il driver miniport di visualizzazione.

Sintassi

PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;

HRESULT Pfnd3dddiEscapecb(
  HANDLE hAdapter,
  const D3DDDICB_ESCAPE *unnamedParam2
)
{...}

Parametri

hAdapter

Handle per l'oggetto scheda grafica.

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDICB_ESCAPE che descrive le informazioni condivise.

Valore restituito

pfnEscapeCb restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Le informazioni sono state condivise correttamente.
E_OUTOFMEMORY	PfnEscapeCb non è riuscito a completare a causa di memoria insufficiente.
E_INVALIDARG	I parametri sono stati convalidati e sono stati determinati come non corretti.
D3DDDIERR_DEVICEREMOVED	PfnEscapeCb non è riuscito ad avviare una chiamata alla funzione DxgkDdiEscape del driver miniport di visualizzazione perché si è verificato un evento di rilevamento e ripristino del timeout (TDR) Plug and Play (PnP). La funzione del driver di visualizzazione in modalità utente che ha chiamato pfnEscapeCb deve restituire il codice di errore al runtime Direct3D. Direct3D versione 9 Nota: per altre informazioni sulla restituzione di codici di errore, vedere Restituzione dei codici di errore ricevuti dalle funzioni di runtime. Direct3D versioni 10 e 11 Nota: se la funzione driver non restituisce un valore ,ovvero ha VOID per un tipo di parametro restituito, la funzione driver chiama la funzione pfnSetErrorCb per inviare un codice di errore al runtime. Per altre informazioni sulla gestione dei codici di errore, vedere Gestione degli errori.

 

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

Un driver di visualizzazione in modalità utente chiama pfnEscapeCb per condividere informazioni varie con il driver miniport di visualizzazione in modo che non sia supportato da altre comunicazioni driver. Il driver di visualizzazione in modalità utente può inviare informazioni varie al driver miniport di visualizzazione o può recuperare informazioni dal driver miniport di visualizzazione.

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

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_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape