PFND3DDDI_RENAME Rückruffunktion (d3dumddi.h)
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) |