VideoPortCompleteDma, fonction (video.h)
La fonction VideoPortCompleteDma vide toutes les données restantes dans le cache interne d’un adaptateur maître bus à la fin d’une opération de transfert DMA, puis libère les registres de carte précédemment alloués et la liste de nuages de points/collecte utilisés dans les opérations DMA de nuage de points/collecte.
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 VP_DMA_ADAPTER qui représente l’adaptateur maître de 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. Une valeur de TRUE désigne un transfert de la mémoire tampon vers l’appareil et une valeur de FALSE indique un transfert de l’appareil vers la mémoire tampon.
Valeur de retour
VideoPortCompleteDma retourne NO_ERROR.
Remarques
Le pilote de miniport vidéo doit appeler VideoPortCompleteDma immédiatement pour libérer des ressources système une fois qu’un transfert DMA a été effectué.
Il est important de noter que la liste de points/regroupements générée par VideoPortStartDma devient non valide lorsque VideoPortCompleteDma est appelée..
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | video.h (include Video.h) |
| bibliothèque | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |