VideoPortCompleteDma, fonction (video.h)
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 |