IPinCount-Schnittstelle (portcls.h)

Die IPinCount-Schnittstelle bietet eine Möglichkeit für den Miniporttreiber, seine Pinanzahl dynamisch zu überwachen und zu bearbeiten, da Pins instanziiert und geschlossen werden. Diese Schnittstelle wird im Miniporttreiber implementiert. Um festzustellen, ob ein Miniporttreiber diese Schnittstelle unterstützt, ruft der Porttreiber die QueryInterface-Methode des Miniportobjekts mit REFIID-IID_IPinCountauf. IPinCount erbt von der IUnknown Schnittstelle.

Die folgenden Porttreiber verwenden die IPinCount-Schnittstelle eines Miniporttreibers, wenn der Miniporttreiber sie implementiert: WaveCyclic, WavePci, MIDI, DMus und Topology.

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 der Kernelstreaming-Pin-Anzahl benachrichtigt.
• Dynamisches Ändern der Pinanzahl.

Bei einem Wellenaudiogerät, z. B. Datenströme mit unterschiedlichen Attributen (3D, Stereo/Mono usw.), können auch unterschiedliche "Gewichtungen" in Bezug auf die Menge der von ihnen verbrauchten Hardwareressourcen aufweisen.

Beim Öffnen eines "Schwergewichts"-Datenstroms muss der Miniporttreiber möglicherweise die verfügbare Pinanzahl um zwei statt um eins erhöhen, um die Anzahl der Pins genauer anzugeben, die mit den verbleibenden Ressourcen erstellt werden können.

Der Prozess wird umgekehrt, wenn ein "Schwergewicht"-Datenstrom geschlossen wird. Die verfügbare Pinanzahl kann um mehr als eins erhöht werden, um die Tatsache widerzuspiegeln, dass zwei oder mehr "lightweight"-Datenströme aus den neu freigegebenen Ressourcen erstellt werden können.

Wenn ein Miniporttreiber die IPinCount Schnittstelle nicht unterstützt, verwendet der Porttreiber die statisch initialisierte Pinanzahl 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.

Erbschaft

Die IPinCount Schnittstelle erbt von der IUnknown-Schnittstelle.

Methodik

Die IPinCount Schnittstelle hat diese Methoden.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	portcls.h