PFND3DDDI_ESCAPECB Rückruffunktion (d3dumddi.h)
Die Rückruffunktion pfnEscapeCb 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 [ein, aus]
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 | Informationen wurden erfolgreich freigegeben. |
| E_OUTOFMEMORY | pfnEscapeCb konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden. |
| E_INVALIDARG | Parameter wurden überprüft und als falsch ermittelt. |
| D3DDDIERR_DEVICEREMOVED | pfnEscapeCb konnte keinen Aufruf der DxgkDdiEscape-Funktion des Anzeigeminiporttreibers initiieren, da ein Plug & Play (PnP) beendet oder ein TDR-Ereignis (Timeout Detection and Recovery) aufgetreten ist. Die Benutzermodusanzeigetreiberfunktion, die pfnEscapeCb aufgerufen hat, muss diesen Fehlercode an die Direct3D-Runtime zurückgeben. Direct3D Version 9 Hinweis: Weitere Informationen zum Zurückgeben von Fehlercodes finden Sie unter Zurückgeben von Fehlercodes, die von Laufzeitfunktionen empfangen wurden. Direct3D, Versionen 10 und 11 Hinweis: Wenn die Treiberfunktion keinen Wert zurückgibt (das heißt, hat VOID für einen Rückgabeparametertyp), ruft die Treiberfunktion die Funktion pfnSetErrorCb auf, um einen Fehlercode zurück an die Runtime zu senden. Weitere Informationen zur Behandlung von Fehlercodes finden Sie unter Behandeln von Fehlern. |
Diese Funktion kann auch andere HRESULT-Werte zurückgeben.
Hinweise
Ein Benutzermodusanzeigetreiber ruft pfnEscapeCb auf, um verschiedene Informationen mit dem Anzeigeminiporttreiber auf eine Weise zu teilen, die von keiner anderen Treiberkommunikation unterstützt wird. Der Benutzermodusanzeigetreiber kann verschiedene Informationen an den Anzeigeminiporttreiber senden oder Informationen aus dem Anzeigeminiporttreiber abrufen.
Direct3D Version 11 Hinweis: Weitere Informationen dazu, wie der Treiber pfnEscapeCb aufruft, finden Sie unter Änderungen von Direct3D 10.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |