D3DKMTUpdateGpuVirtualAddress, fonction (d3dkmthk.h)

  • Article

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

Syntaxe

NTSTATUS D3DKMTUpdateGpuVirtualAddress(
  [in] const D3DKMT_UPDATEGPUVIRTUALADDRESS *unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers une structure D3DKMT_UPDATEGPUVIRTUALADDRESS qui décrit l’opération.

Valeur retournée

Code de retour Description
STATUS_SUCCESS Le contexte de l’appareil a été créé avec succès.
STATUS_INVALID_PARAMETER Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs NTSTATUS .

Remarques

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

Les mises à jour des tables 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 que le contexte de rendu associé a signalé FenceValue pour l’objet de clôture surveillé spécifié. Une fois les mises à jour de la table de pages terminées, le contexte de pagination signale l’objet de clôture surveillé à FenceValue+1, ce qui permet au contexte de rendu d’effectuer un verrouillage étroit avec les mises à jour de la table de pages.

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

Dans un seul appel UpdateVirtualAddress :

  • 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 sources dans les opérations de copie est autorisée à provenir d’une autre plage réservée (zéro).
  • La plage d’adresses virtuelles sources dans toutes les opérations de copie doit appartenir à la même plage réservée (zéro).

Les pilotes peuvent envoyer de nombreux appels UpdateGpuVirtualAddress , qui 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Universal
En-tête d3dkmthk.h (include D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_UPDATEGPUVIRTUALADDRESS

ReserveGpuVirtualAddressRange