PFND3DDDI_ESCAPECB Rückruffunktion (d3dumddi.h)
Die pfnEscapeCb Rückruffunktion teilt Informationen mit dem Anzeigeminiporttreiber.
Syntax
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
Parameter
hAdapter
Ein Handle für das Grafikadapterobjekt.
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDICB_ESCAPE Struktur, die die freigegebenen Informationen beschreibt.
Rückgabewert
pfnEscapeCb gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Informationen wurden erfolgreich freigegeben. |
| E_OUTOFMEMORY | pfnEscapeCb konnte aufgrund unzureichender Arbeitsspeichers nicht abgeschlossen werden. |
| E_INVALIDARG | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
| D3DDDIERR_DEVICEREMOVED | pfnEscapeCb konnte keinen Aufruf des DxgkDdiEscape-Funktion des Anzeigeminiporttreibers initiieren, da ein Plug and Play (PnP)-Stopp oder ein TDR-Ereignis (Timeout Detection and Recovery) aufgetreten ist. Die Anzeigetreiberfunktion des Benutzermodus, die pfnEscapeCb aufgerufen hat, muss diesen Fehlercode zurück an die Direct3D-Laufzeit zurückgeben. Direct3D Version 9 Hinweis: Weitere Informationen zum Zurückgeben von Fehlercodes finden Sie unter Rückgabe von Fehlercodes, die von Laufzeitfunktionenempfangen wurden. Direct3D-Versionen 10 und 11 Hinweis: Wenn die Treiberfunktion keinen Wert zurückgibt (d. h. leer für einen Rückgabeparametertyp), ruft die Treiberfunktion die pfnSetErrorCb--Funktion auf, um einen Fehlercode zurück an die Laufzeit zu senden. Weitere Informationen zum Behandeln von Fehlercodes finden Sie unter Behandlung von Fehlern. |
Diese Funktion kann auch andere HRESULT-Werte zurückgeben.
Bemerkungen
Ein Benutzermodusanzeigetreiber ruft pfnEscapeCb auf, verschiedene Informationen mit dem Anzeigeminiporttreiber auf eine Weise freizugeben, die von keiner anderen Treiberkommunikation unterstützt wird. Der Anzeigetreiber für den Benutzermodus kann verschiedene Informationen an den Anzeigeminiporttreiber senden oder Informationen vom Anzeigeminiporttreiber abrufen.
Direct3D Version 11 Hinweis: Weitere Informationen dazu, wie der Treiber pfnEscapeCbaufruft, finden Sie unter Änderungen von Direct3D 10.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |