PFND3DDDI_RESOLVESHAREDRESOURCE fonction de rappel (d3dumddi.h)

Article
02/26/2024

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 (c’est-à-dire le contexte graphique) associé à la surface partagée ou à la surface interopérable GDI.

unnamedParam2

pData [in]

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

Valeur retournée

ResolveSharedResource retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	La ressource est correctement résolue.
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ée change ou lorsqu’une surface est utilisée pour l’interopérabilité GDI. Le runtime fournit ResolveSharedResource avec des handles sur l’appareil d’affichage via le paramètre hDevice et la 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 sur la mémoire pour le rendu de plusieurs GPU. Le pilote peut implémenter ResolveSharedResource pour réinséréger chaque ressource afin que le nouveau propriétaire de la ressource ait la ressource fusionnée. Le pilote doit vider toutes les mémoires tampons de commande partiellement générées susceptibles de modifier la ressource.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	ResolveSharedResource est pris en charge à partir du système d’exploitation Windows 7.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Partager via