PFND3DDDI_RENAME fonction de rappel (d3dumddi.h)

Article
08/07/2023

La fonction Rename informe un pilote d’affichage en mode utilisateur de commencer à utiliser l’allocation renommée que la fonction LockAsync a précédemment retournée pour la ressource spécifiée.

Syntaxe

PFND3DDDI_RENAME Pfnd3dddiRename;

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

Paramètres

hDevice

Handle sur un périphérique d’affichage (c’est-à-dire le contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure de D3DDDIARG_RENAME qui décrit la ressource ou la surface d’une ressource à renommer avec une nouvelle allocation.

Valeur retournée

Renommer retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	La ressource est renommée.
E_OUTOFMEMORY	Le nom n’a pas pu allouer la mémoire nécessaire pour qu’il se termine.

Remarques

Sur les ordinateurs à plusieurs processeurs, le runtime Microsoft Direct3D appelle la fonction Renommer du pilote d’affichage en mode utilisateur à partir d’un thread de travail au lieu du thread d’application main. Le runtime appelle renommer, au maximum, une fois pour chaque appel réussi à la fonction LockAsync du pilote avec l’indicateur de champ de bits Ignorer défini dans le membre Flags de la structure D3DDDIARG_LOCKASYNC vers laquelle pointe le paramètre pData de LockAsync .

Rename indique au pilote de commencer à utiliser l’allocation renommée spécifiée par le membre hCookie de la structure D3DDDIARG_RENAME vers laquelle pointe le paramètre pData de Rename . Le handle hCookie a été précédemment retourné par la fonction LockAsync si l’indicateur de champ de bits Ignorer a été défini pour la ressource verrouillée.

Une fois rename retourné avec succès (avec S_OK), le pilote d’affichage en mode utilisateur doit utiliser l’allocation spécifiée par hCookie pour toutes les opérations de rendu qui référencent la ressource que les membres hResource et SubResourceIndex de D3DDDIARG_RENAME spécifient.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Universal
En-tête	d3dumddi.h (inclure D3dumddi.h)

Voir aussi