PFND3DDDI_UPDATEGPUVIRTUALADDRESSCB fonction de rappel (d3dumddi.h)

Article
06/02/2025

pfnUpdateGpuVirtualAddressCb est une opération spéciale utilisée dans le contexte des ressources de vignette. Il permet au pilote en mode utilisateur de spécifier un certain nombre d’opérations de mappage à appliquer à l’espace d’adressage virtuel du processus dans un lot unique de mises à jour de la table de pages.

La plage d’adresses virtuelles d’unité de traitement graphique (GPU) dans toutes les opérations (à l’exception de l’adresse source des opérations de copie) doit appartenir à une plage d’adresses virtuelle unique obtenue en appelant pfnReserveGpuVirtualAddressCb. De même, les plages d’adresses virtuelles de toutes les sources des opérations de copie doivent appartenir à une plage d’adresses virtuelle unique, obtenue en appelant pfnReserveGpuVirtualAddressCb.

Les mises à jour de la table de pages sont exécutées sur un contexte de pagination, dédiée au contexte de rendu spécifié et exécutées sur le GPU uniquement après le contexte de rendu associé signalé FenceValue pour l’objet de clôture supervisé spécifié. Une fois les mises à jour de la table de pages terminées, le contexte de pagination signale à l’objet de clôture supervisé FenceValue+1, ce qui permet au contexte de rendu d’effectuer un verrouillage étroit avec les mises à jour de la table de pages.

Syntaxe

PFND3DDDI_UPDATEGPUVIRTUALADDRESSCB Pfnd3dddiUpdategpuvirtualaddresscb;

HRESULT Pfnd3dddiUpdategpuvirtualaddresscb(
  HANDLE hDevice,
  const D3DDDICB_UPDATEGPUVIRTUALADDRESS *unnamedParam2
)
{...}

Paramètres

hDevice

Handle vers l’appareil d’affichage.

unnamedParam2

pData [in]

Pointeur vers une structure D3DDDICB_UPDATEGPUVIRTUALADDRESS qui décrit l’opération à effectuer.

Valeur de retour

Si cette fonction de rappel réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.

Remarques

Les plages d’adresses virtuelles des opérations de mise à jour sont autorisées à se croiser. Les opérations seront appliquées dans l’ordre dans lequel elles sont envoyées.

Dans un seul appel pfnUpdateVirtualAddressCb :

Toutes les plages d’adresses virtuelles dans les opérations de mappage et la plage de destination dans les opérations de copie doivent appartenir à la même plage réservée (zéro).
La plage d’adresses virtuelles source dans les opérations de copie est autorisée à partir d’une autre plage réservée (zéro).
La plage d’adresses virtuelles source dans toutes les opérations de copie doit appartenir à la même plage réservée (zéro).

Le pilote en mode utilisateur peut envoyer de nombreux appels pfnUpdateGpuVirtualAddressCb appels et opérations seront mis en file d’attente derrière la clôture de rendu. Lorsque le nombre d’opérations de mise à jour en file d’attente dépasse 128, le thread appelant est bloqué jusqu’à ce que les opérations précédentes soient traitées par le gestionnaire de mémoire vidéo.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Bureau
d’en-tête	d3dumddi.h (include D3dumddi.h)

Voir aussi

D3DDDICB_UPDATEGPUVIRTUALADDRESS

pfnReserveGpuVirtualAddressCb

Partager via