Freigeben über


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)

Siehe auch

D3DDDICB_ESCAPE

D3DDDI_DEVICECALLBACKS

DxgkDdiEscape-