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) |