PFND3DDDI_RENAME Rückruffunktion (d3dumddi.h)

Artikel
02/23/2024

Die Umbenennen-Funktion informiert einen Anzeigetreiber im Benutzermodus, die umbenannte Zuordnung zu verwenden, die die LockAsync-Funktion zuvor für die angegebene Ressource zurückgegeben hat.

Syntax

PFND3DDDI_RENAME Pfnd3dddiRename;

HRESULT Pfnd3dddiRename(
  HANDLE hDevice,
  const D3DDDIARG_RENAME *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für ein Anzeigegerät (d. a. den Grafikkontext).

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDIARG_RENAME Struktur, die die Ressource oder Oberfläche innerhalb einer Ressource beschreibt, die mit einer neuen Zuordnung umbenannt werden soll.

Rückgabewert

Rename gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Die Ressource wurde erfolgreich umbenannt.
E_OUTOFMEMORY	Umbenennen konnte nicht den erforderlichen Arbeitsspeicher zuordnen, damit dieser vollständig abgeschlossen werden konnte.

Hinweise

Auf Computern mit mehreren Prozessoren ruft die Microsoft Direct3D-Runtime die Umbenennen-Funktion des Benutzermodusanzeigetreibers aus einem Arbeitsthread und nicht aus dem Standard Anwendungsthreads auf. Die Laufzeit ruft Rename höchstens einmal für jeden erfolgreichen Aufruf der LockAsync-Funktion des Treibers auf, wobei im Flags-Element der D3DDDIARG_LOCKASYNC-Struktur, auf die der pData-Parameter von LockAsync verweist, das Flag-Flag verwerfen festgelegt ist.

Rename informiert den Treiber, mit der Verwendung der umbenannten Zuordnung zu beginnen, die vom hCookie-Element der D3DDDIARG_RENAME-Struktur angegeben wird, auf die der pData-Parameter von Rename verweist. Das hCookie-Handle wurde zuvor von der LockAsync-Funktion zurückgegeben, wenn das Flag Bitfeld verwerfen für die gesperrte Ressource festgelegt wurde.

Nachdem Rename erfolgreich zurückgegeben wurde (mit S_OK), sollte der Benutzermodusanzeigetreiber die Zuordnung verwenden, die hCookie für alle Renderingvorgänge angibt, die auf die Ressource verweisen, die die hResource - und SubResourceIndex-Member von D3DDDIARG_RENAME angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	d3dumddi.h (include D3dumddi.h)

Weitere Informationen