VideoPortCompleteDma, fonction (video.h)

  • Article

La fonction VideoPortCompleteDma vide toutes les données restantes dans le cache interne d’un adaptateur master bus à la fin d’une opération de transfert DMA, puis libère les registres cartographiques et la liste de points/regroupement précédemment alloués utilisés dans les opérations DMA de nuages de points/regroupements.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCompleteDma(
  [in] IN PVOID                   HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER         VpDmaAdapter,
  [in] IN PVP_SCATTER_GATHER_LIST VpScatterGather,
  [in] IN BOOLEAN                 WriteToDevice
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] VpDmaAdapter

Pointeur vers une structure de VP_DMA_ADAPTER qui représente l’adaptateur master bus. Cette structure a été retournée par un appel à VideoPortGetDmaAdapter.

[in] VpScatterGather

Pointeur vers la structure VP_SCATTER_GATHER_LIST précédemment passée à la routine de rappel du pilote miniport, HwVidExecuteDma.

[in] WriteToDevice

Spécifie la direction du transfert DMA. La valeur TRUE indique un transfert de la mémoire tampon vers l’appareil, et la valeur FALSE indique un transfert de l’appareil vers la mémoire tampon.

Valeur retournée

VideoPortCompleteDma retourne NO_ERROR.

Remarques

Le pilote de miniport vidéo doit appeler Immédiatement VideoPortCompleteDma pour libérer des ressources système une fois le transfert DMA terminé.

Il est important de noter que la liste de points/regroupements créée par VideoPortStartDma devient non valide lorsque VideoPortCompleteDma est appelé..

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête video.h (incluez Video.h)
Bibliothèque Videoprt.lib
DLL Videoprt.sys
IRQL <=DISPATCH_LEVEL

Voir aussi

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma