PMINIPORT_SYNCHRONIZE_ROUTINE fonction de rappel (video.h)

HwVidSynchronizeExecutionCallback est une fonction de pilote miniport facultative, passée dans les appels à VideoPortSynchronizeExecution.

Syntaxe

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

Paramètres

Context

Pointeur vers les données de contexte passées à la routine de rappel via VideoPortSynchronizeExecution. En règle générale, il s’agit d’un pointeur vers l’extension d’appareil ou d’un décalage dans l’extension de l’appareil.

Valeur retournée

Si l’opération réussit, HwVidSynchronizeExecutionCallback retourne TRUE.

Remarques

Un pilote miniport avec une ou plusieurs fonctions qui partagent de la mémoire avec sa fonction HwVidInterrupt doit avoir une fonction HwVidSynchronizeExecutionCallback . Toute fonction qui partage de la mémoire avec HwVidInterrupt doit appeler VideoPortSynchronizeExecution avec la fonction HwVidSynchronizeExecutionCallback pour maintenir l’intégrité des données dans la zone de mémoire partagée. Autrement dit, une seule des fonctions HwVidSynchronizeExecutionCallback et HwVidInterrupt peut mettre à jour l’état dans la zone partagée à un moment donné.

Le pilote miniport d’un adaptateur qui ne génère pas d’interruptions peut également avoir une fonction HwVidSynchronizeExecutionCallback à passer à VideoPortSynchronizeExecution lorsqu’un tel pilote doit effectuer un travail critique avec une priorité d’exécution relativement élevée. Par exemple, les pilotes miniport compatibles VGA avec des fonctions SvgaHwIoPortXxx (voir Fonctions SVGA) peuvent avoir une fonction HwVidSynchronizeExecutionCallback qui est chargée de transférer les E/S émises par l’application en mémoire tampon et validées par l’application vers l’adaptateur.

HwVidSynchronizeExecutionCallback ne doit pas être rendu paginable.

Configuration requise

Voir aussi

HwVidInterrupt

SVGA Functions

VideoPortSynchronizeExecution