Méthode IPortWavePciStream ::TerminatePacket (portcls.h)

La TerminatePacket méthode termine le paquet en cours de mappage.

Syntaxe

NTSTATUS TerminatePacket();

Valeur de retour

TerminatePacket retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Cette méthode est principalement utilisée pour les situations de capture dans lesquelles les paquets d’E/S doivent se terminer à des points spécifiques du flux (par exemple, pour se synchroniser avec des trames vidéo). La mémoire tampon de données d’une broche de capture sur un périphérique audio se compose d’un ou plusieurs paquets d’E/S. Chaque paquet d’E/S est la partie de la mémoire tampon de données qui est attachée à un IRP de mappage particulier. Par défaut, alors qu’un flux de capture est à l’état KSSTATE_RUN, le contenu d’un paquet d’E/S ne devient disponible pour le client que lorsque le dernier mappage du paquet a été rempli. La TerminatePacket méthode rend un paquet partiellement rempli immédiatement disponible pour le client sans attendre de données de capture supplémentaires.

La modification de l’état d’un flux de capture de KSSTATE_RUN en KSSTATE_STOP met automatiquement fin au paquet d’E/S actuel.

Configuration requise