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)

Weitere Informationen

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape