PFND3DDDI_RESOLVESHAREDRESOURCE Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Die funktion ResolveSharedResource informiert einen Anzeigetreiber im Benutzermodus, der den Besitz einer freigegebenen Oberfläche geändert hat oder dass eine Oberfläche für die GDI-Interoperabilität verwendet wird.

Syntax

PFND3DDDI_RESOLVESHAREDRESOURCE Pfnd3dddiResolvesharedresource;

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

Parameter

hDevice

Ein Handle für das Anzeigegerät (d. h. den Grafikkontext), der der gemeinsam genutzten Oberfläche oder der GDI-interoperablen Oberfläche zugeordnet ist.

unnamedParam2

pData- [in]

Ein Zeiger auf eine D3DDDIARG_RESOLVESHAREDRESOURCE Struktur, die einen Ziehpunkt auf die Oberfläche enthält.

Rückgabewert

ResolveSharedResource- gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Ressource wurde erfolgreich aufgelöst.
D3DDDIERR_DEVICEREMOVED	Der Treiber erkennt, dass der Grafikadapter entfernt wurde. Daher hat der Treiber den Vorgang nicht abgeschlossen. Wenn der Treiber nie die Bedingung zum Entfernen des Adapters bemerkt, ist der Treiber nicht erforderlich, um diesen Fehlercode zurückzugeben.

Bemerkungen

Die Direct3D-Laufzeit ruft ResolveSharedResource- auf, wenn eine Anwendung eine der folgenden Funktionen aufruft:

IDXGIKeyedMutex::ReleaseSynch auf einer synchronisierten freigegebenen Oberfläche
IDXGISurface1::GetDC für eine interoperable GDI-Oberfläche

Die Laufzeit ruft die ResolveSharedResource- funktion des Treibers bei jeder Änderung eines gemeinsam genutzten Oberflächenbesitzers oder bei Verwendung einer Oberfläche für die GDI-Interoperabilität auf. Die Laufzeit stellt ResolveSharedResource- mit Handles für das Anzeigegerät bereit– über den hDevice Parameter - und die Oberfläche - über den pData--Parameter.

Der Treiber implementiert ResolveSharedResource-, um Ressourcen für mehrere GPU-Szenarien entsprechend zu verwalten. Jede Ressource kann über mehrere GPUs verteilt werden, auf denen sie gerendert werden können. Der Treiber kann ResolveSharedResource- implementieren, um jede Ressource zu überführen, sodass der neue Ressourcenbesitzer über die zusammengeführte Ressource verfügt. Der Treiber muss alle teilweise erstellten Befehlspuffer leeren, die die Ressource ändern können.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	ResolveSharedResource wird ab dem Windows 7-Betriebssystem unterstützt.
Zielplattform-	Desktop
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Freigeben über