WavePci-Porttreiber

Wichtig Die Verwendung von WavePci wird nicht mehr empfohlen, anstatt WaverRT zu verwenden.

Der WavePci-Porttreiber verwaltet die Wiedergabe oder Aufzeichnung eines Wellenstroms durch ein Audiogerät, das Punkt-/Sammel-DMA-Übertragungen an oder von einem beliebigen Ort im physischen Speicher durchführen kann. Mit Scatter/Gather-DMA kann das Gerät Audiodaten in einem Puffer verarbeiten, der aus einer Reihe von Zuordnungen besteht. Jede Zuordnung ist ein Block physischer zusammenhängender Speicher, aber aufeinander folgende Zuordnungen sind nicht notwendigerweise miteinander zusammenhängend. Das WavePci-kompatible Gerät ist eine Hardwarefunktion auf einem Audioadapter. Normalerweise ist der Adapter Teil eines integrierten Chipsatzes auf der Hauptplatine oder ist auf einer Audiokarte montiert, die an einen PCI-Steckplatz auf der Hauptplatine angeschlossen ist. Der Adaptertreiber stellt einen entsprechenden WavePci Miniport-Treiber bereit, der an das WavePci-Porttreiberobjekt gebunden ist, um einen Wellenfilter zu bilden, der einen Wellenstrom erfassen oder rendern kann.

Der WavePci-Porttreiber macht dem Miniporttreiber eine IPortWavePci-Schnittstelle verfügbar. IPortWavePci erbt die Methoden in IPort der Basisschnittstelle. Darüber hinaus stellt IPortWavePci die folgenden Methoden bereit:

IPortWavePci::NewMasterDmaChannel

Erstellt ein neues Master-DMA-Kanalobjekt. IPortWavePci::Notify

Benachrichtigt den Porttreiber, dass der DMA-Controller zu einer neuen Position im Audiodatenstrom fortgeschritten ist. Der WavePci-Porttreiber macht auch eine IPortWavePciStream-Schnittstelle für jedes der Streamobjekte des Miniporttreibers verfügbar. IPortWavePciStream erbt die Methoden in der Basisschnittstelle IUnknown. IPortWavePciStream stellt die folgenden zusätzlichen Methoden bereit:

IPortWavePciStream::GetMapping

Ruft die nächste Zuordnung aus dem Treiber für den Port ab. IPortWavePciStream::ReleaseMapping

Gibt eine Zuordnung frei, die zuvor durch einen GetMapping-Aufruf erhalten wurde. IPortWavePciStream::TerminatePacket

Beendet ein E/A-Paket, auch wenn es nur teilweise mit Erfassungsdaten gefüllt ist. Ein E/A-Paket ist ein Teil des Audiopuffers, der alle Zuordnungen umfasst, die mit einem bestimmten Zuordnungs-IRP verknüpft sind.

Die WavePci-Port- und Miniportobjekte kommunizieren über ihre jeweiligen IPortWavePci - und IMiniportWavePci-Schnittstellen miteinander. Darüber hinaus kommunizieren die WavePci-Port- und Miniportstreamobjekte über ihre jeweiligen IPortWavePciStream - und IMiniportWavePciStream-Schnittstellen miteinander.