PFND3DDDI_RESOLVESHAREDRESOURCE Rückruffunktion (d3dumddi.h)

Artikel
02/23/2024

Die ResolveSharedResource-Funktion informiert einen Anzeigetreiber im Benutzermodus darüber, dass sich der Besitz einer freigegebenen Oberfläche geändert hat oder dass eine Oberfläche für die GDI-Interoperation 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), das der gemeinsam genutzten Oder GDI-interoperablen Oberfläche zugeordnet ist.

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDIARG_RESOLVESHAREDRESOURCE Struktur, die einen Ziehpunkt zur 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 die Grafikkarte entfernt wurde. Daher hat der Treiber den Vorgang nicht abgeschlossen. Wenn der Treiber die Bedingung zum Entfernen des Adapters nie bemerkt, muss der Treiber diesen Fehlercode nicht zurückgeben.

Hinweise

Die Direct3D-Runtime 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 Runtime ruft die ResolveSharedResource-Funktion des Treibers bei jeder Änderung eines freigegebenen Surface-Besitzers auf oder wenn eine Oberfläche für die GDI-Interoperation verwendet wird. Die Runtime stellt ResolveSharedResource mit Handles für das Anzeigegerät bereit– über den hDevice-Parameter und surface über den pData-Parameter .

Der Treiber implementiert ResolveSharedResource , um Ressourcen für mehrere GPU-Szenarien angemessen zu verwalten. Jede Ressource kann auf den Arbeitsspeicher aufgeteilt werden, auf dem mehrere GPUs gerendert werden sollen. Der Treiber kann ResolveSharedResource implementieren, um jede Ressource erneut zu verwenden, sodass der neue Ressourcenbesitzer über die zusammengeführte Ressource verfügt. Der Treiber muss alle teilweise erstellten Befehlspuffer leeren, die die Ressource möglicherweise ändern.

Anforderungen

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

Weitere Informationen

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Freigeben über