IPinCount-Schnittstelle (portcls.h)

Die IPinCount -Schnittstelle bietet dem Miniporttreiber eine Möglichkeit, seine Pinanzahl dynamisch zu überwachen und zu bearbeiten, während Pins instanziiert und geschlossen werden. Diese Schnittstelle ist im Miniporttreiber implementiert. Um festzustellen, ob ein Miniporttreiber diese Schnittstelle unterstützt, ruft der Porttreiber die QueryInterface-Methode des Miniportobjekts mit REFIID IID_IPinCount auf. IPinCount erbt von der IUnknown-Schnittstelle .

Die folgenden Porttreiber verwenden eine Miniporttreiberschnittstelle IPinCount , wenn der Miniporttreiber sie implementiert: WaveCyclic, WavePci, MIDI, DMus und Topologie.

IPinCount ist eine optionale Schnittstelle, die ein Miniporttreiber unterstützen kann, wenn er eine oder beide der folgenden Aktionen ausführen muss:

• Sie werden explizit über Änderungen bei der Anzahl der Kernelstreaming-Pins benachrichtigt.
• Dynamisches Ändern der Pinanzahl.

Im Falle eines Wave-Audiogeräts können Datenströme mit unterschiedlichen Attributen (3D, Stereo/Mono usw.) auch unterschiedliche "Gewichtungen" hinsichtlich der Menge an Hardwareressourcen aufweisen, die sie verbrauchen.

Beim Öffnen eines "schwergewichtigen" Datenstroms muss der Miniporttreiber möglicherweise die anzahl verfügbarer Pins um zwei statt um eins verringern, um die Anzahl der Pins, die mit den verbleibenden Ressourcen erstellt werden können, genauer anzugeben.

Der Prozess wird umgekehrt, wenn ein "Schwergewicht"-Stream geschlossen wird. Die Anzahl der verfügbaren Pins kann um mehrere erhöht werden, um die Tatsache widerzuspiegeln, dass zwei oder mehr "Lightweight"-Streams aus den neu freigegebenen Ressourcen erstellt werden können.

Wenn ein Miniporttreiber die IPinCount Schnittstelle nicht unterstützt, verwendet der Porttreiber die statisch initialisierten Pinanzahlen im PCPIN_DESCRIPTOR Array des Filters.

Die IPinCount -Schnittstelle stellt eine einzelne Methode bereit. Der Porttreiber, der an den Miniporttreiber gebunden ist, ruft diese Methode als Reaktion auf eine Pin-Count-Abfrage auf.

Vererbung

Die IPinCount-Schnittstelle erbt von der IUnknown-Schnittstelle.

Methoden

Die IPinCount-Schnittstelle verfügt über diese Methoden.

IPinCount::P inCount Die PinCount-Methode fragt den Miniporttreiber nach seiner Pinanzahl ab.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	portcls.h