PFND3DDDI_RESOLVESHAREDRESOURCE fonction de rappel (d3dumddi.h)

Article
02/06/2025

La fonction ResolveSharedResource informe un pilote d’affichage en mode utilisateur que la propriété d’une surface partagée a changé ou qu’une surface est utilisée pour l’interopérabilité GDI.

Syntaxe

PFND3DDDI_RESOLVESHAREDRESOURCE Pfnd3dddiResolvesharedresource;

HRESULT Pfnd3dddiResolvesharedresource(
  HANDLE hDevice,
  const D3DDDIARG_RESOLVESHAREDRESOURCE *unnamedParam2
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (autrement dit, le contexte graphique) associé à la surface partagée ou à l’aire interopérable GDI.

unnamedParam2

pData [in]

Pointeur vers une structure D3DDDIARG_RESOLVESHAREDRESOURCE qui contient un handle à la surface.

Valeur de retour

ResolveSharedResource retourne l’une des valeurs suivantes :

Retourner le code	Description
S_OK	La ressource est résolue avec succès.
D3DDDIERR_DEVICEREMOVED	Le pilote détecte que la carte graphique a été supprimée. Par conséquent, le pilote n’a pas terminé l’opération. Si le pilote ne remarque jamais la condition de suppression de l’adaptateur, il n’est pas nécessaire de retourner ce code d’erreur.

Remarques

Le runtime Direct3D appelle ResolveSharedResource lorsqu’une application appelle l’une des fonctions suivantes :

IDXGIKeyedMutex ::ReleaseSynch sur une surface partagée synchronisée
IDXGISurface1 ::GetDC pour une surface interopérable GDI

Le runtime appelle la fonction ResolveSharedResource du pilote chaque fois qu’un propriétaire de surface partagé change ou lorsqu’une surface est utilisée pour l’interopérabilité GDI. Le runtime fournit ResolveSharedResource avec des handles à l’appareil d’affichage via le paramètre hDevice et le surface via le paramètre pData.

Le pilote implémente ResolveSharedResource pour gérer correctement les ressources pour plusieurs scénarios GPU. Chaque ressource peut être divisée en mémoire pour plusieurs GPU à afficher. Le pilote peut implémenter ResolveSharedResource pour rémerger chaque ressource afin que le nouveau propriétaire de la ressource ait la ressource fusionnée. Le pilote doit vider les mémoires tampons de commande partiellement générées susceptibles de modifier la ressource.

Exigences

Exigence	Valeur
client minimum pris en charge	ResolveSharedResource est pris en charge à partir du système d’exploitation Windows 7.
plateforme cible	Bureau
d’en-tête	d3dumddi.h (include D3dumddi.h)

Voir aussi

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Partager via