Pilote de Port WavePci

Important L’utilisation de WavePci n’est plus recommandée, à la place utiliser WaverRT.

Le pilote de port WavePci gère la lecture ou l’enregistrement d’un flux audio par un périphérique audio capable d’effectuer des transferts DMA scatter/gather vers ou depuis n’importe quel emplacement, en mémoire physique. Avec le DMA segmenté, l'appareil peut traiter les données audio dans un tampon composé d'une série de segments. Chaque mappage est un bloc de mémoire physiquement contiguë, mais les mappages successifs ne sont pas nécessairement contigus les uns aux autres. L’appareil compatible WavePci est une fonction matérielle sur une carte audio. En règle générale, l’adaptateur fait partie d’un microprogramme intégré sur la carte mère ou est monté sur une carte audio qui se connecte à un emplacement PCI sur la carte mère. Le pilote d’adaptateur fournit un pilote miniport WavePci correspondant qui se lie à l’objet pilote de port WavePci pour former un filtre d’ondes qui peut capturer ou afficher un flux d’ondes.

Le pilote de port WavePci expose une interface IPortWavePci au pilote miniport. IPortWavePci hérite des méthodes de l’interface de base IPort. En outre, IPortWavePci fournit les méthodes suivantes :

IPortWavePci ::NewMasterDmaChannel

Crée un nouvel objet de canal DMA principal. IPortWavePci ::Notify

Avertit le pilote de port que le contrôleur DMA a avancé vers une nouvelle position dans le flux audio. Le pilote de port WavePci expose également une interface IPortWavePciStream à chacun des objets de flux du pilote miniport. IPortWavePciStream hérite des méthodes dans l’interface de base IUnknown. IPortWavePciStream fournit les méthodes supplémentaires suivantes :

IPortWavePciStream ::GetMapping

Obtient le mappage suivant à partir du pilote de port. IPortWavePciStream ::ReleaseMapping

Libère un mappage obtenu précédemment par un appel GetMapping. IPortWavePciStream ::TerminatePacket

Met fin à un paquet d’E/S même s’il n’est rempli que partiellement avec des données de capture. Un paquet d’E/S est une partie de la mémoire tampon audio composée de tous les mappages associés à un IRP de mappage particulier.

Le port WavePci et les objets miniport communiquent entre eux via leurs interfaces IPortWavePci et IMiniportWavePci respectives. En outre, le port WavePci et les objets de flux miniport communiquent entre eux via leurs interfaces IPortWavePciStream et IMiniportWavePciStream respectives.