DXGKDDI_UPDATEMONITOREDVALUES fonction de rappel (d3dkmddi.h)

Dxgkrnl appelle DxgkDdiUpdateMonitoredValues pour indiquer au pilote d’affichage en mode noyau (KMD) de mettre à jour un lot de valeurs surveillées.

Syntaxe

DXGKDDI_UPDATEMONITOREDVALUES DxgkddiUpdatemonitoredvalues;

NTSTATUS DxgkddiUpdatemonitoredvalues(
  IN_CONST_PDXGKARG_UPDATEMONITOREDVALUES pUpdateMonitoredValues
)
{...}

Paramètres

pUpdateMonitoredValues

[in] Pointeur vers une structure DXGKARG_UPDATEMONITOREDVALUES qui contient les valeurs surveillées à mettre à jour.

Valeur retournée

DxgkDdiUpdateMonitoredValues retourne STATUS_SUCCESS si KMD a réussi à mettre à jour le lot de valeurs surveillées. Sinon, il retourne un code d’erreur NTSTATUS approprié.

Remarques

DxgkDdiUpdateMonitoredValues s’exécute au niveau de l’interruption de l’appareil et est donc synchronisé avec la routine de service d’interruption signalée (ISR) surveillée.

L’implémentation de DxgkDdiUpdateMonitoredValues d’un KMD doit garantir que la valeur CurrentValue lue par n’importe quel cœur de processeur après le retour de l’appel a été écrite par le processeur de gestion du contexte GPU après avoir observé la nouvelle valeur surveillée.

DxgkDdiUpdateMonitoredValues est censé écrire les valeurs UpdatedValueArray à l’emplacement spécifié par MonitorValueGpuVa tout en respectant le contrat de synchronisation.

Le système d’exploitation garantit uniquement que le pointeur MonitorValueKernelCpuVa est valide pendant la durée de cet appel DDI, et non avant ou après celui-ci. Par conséquent, KMD ne doit jamais mettre en cache ce pointeur pour l’utiliser ailleurs.

Pour plus d’informations sur les clôtures GPU natives, consultez Objets de clôture GPU natifs.

Configuration requise

Voir aussi

DXGKARG_UPDATEMONITOREDVALUES