PFND3DDDI_ESCAPECB fonction de rappel (d3dumddi.h)
La fonction de rappel pfnEscapeCb partage des informations avec le pilote miniport d’affichage.
Syntaxe
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
Paramètres
hAdapter
Handle de l’objet adaptateur graphique.
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDICB_ESCAPE qui décrit les informations partagées.
Valeur de retour
pfnEscapeCb retourne l’une des valeurs suivantes :
| code de retour | Description |
|---|---|
| S_OK | Les informations ont été partagées avec succès. |
| E_OUTOFMEMORY | pfnEscapeCb n’a pas pu se terminer en raison d’une mémoire insuffisante. |
| E_INVALIDARG | Les paramètres ont été validés et déterminés comme incorrects. |
| D3DDDIERR_DEVICEREMOVED | pfnEscapeCb n’a pas pu lancer un appel au DxgkDdiEscape du pilote display miniport, car un arrêt Plug-and-Play (PnP) ou un événement TDR (Timeout Detection and Recovery) s’est produit. La fonction de pilote d’affichage en mode utilisateur appelée pfnEscapeCb doit retourner ce code d’erreur au runtime Direct3D. Direct3D Version 9 Remarque : Pour plus d’informations sur le retour de codes d’erreur, consultez Retour de codes d’erreur reçus à partir de Runtime Functions. Direct3D Versions 10 et 11 Remarque : si la fonction de pilote ne retourne pas de valeur (autrement dit, a VOID pour un type de paramètre de retour), la fonction de pilote appelle la fonction pfnSetErrorCb pour renvoyer un code d’erreur au runtime. Pour plus d’informations sur la gestion des codes d’erreur, consultez Gestion des erreurs. |
Cette fonction peut également retourner d’autres valeurs HRESULT.
Remarques
Un pilote d’affichage en mode utilisateur appelle pfnEscapeCb pour partager diverses informations avec le pilote display miniport d’une manière qui n’est prise en charge par aucune autre communication de pilote. Le pilote d’affichage en mode utilisateur peut envoyer diverses informations au pilote miniport d’affichage ou récupérer des informations à partir du pilote miniport d’affichage.
Direct3D version 11 Remarque : Pour plus d’informations sur la façon dont le pilote appelle pfnEscapeCb, consultez modifications de Direct3D 10.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |