Interface IPinCount (portcls.h)

L’interface IPinCount fournit un moyen pour le pilote miniport de surveiller et de manipuler son nombre de broches dynamiquement, car les broches sont instanciées et fermées. Cette interface est implémentée dans le pilote miniport. Pour déterminer si un pilote miniport prend en charge cette interface, le pilote de port appelle la méthode QueryInterface de l’objet miniport avec le IID_IPinCountREFIID. IPinCount hérite de l’interface IUnknown.

Les pilotes de port suivants utilisent l’interface IPinCount du pilote miniport si le pilote miniport l’implémente : WaveCyclique, WavePci, MIDI, DMus et Topologie.

IPinCount est une interface facultative qu’un pilote miniport peut prendre en charge s’il doit effectuer l’une ou l’autre des opérations suivantes :

• Soyez explicitement informé des modifications apportées au nombre de broches de diffusion en continu du noyau.
• Modifiez dynamiquement son nombre d’épingles.

Dans le cas d’un appareil audio wave, par exemple, des flux avec différents attributs (3D, stéréo/mono, et ainsi de suite) peuvent également avoir des « pondérations » différentes en termes de quantité de ressources matérielles qu’ils consomment.

Lors de l’ouverture d’un flux « heavyweight », le pilote miniport peut avoir besoin de décrémenter le nombre de broches disponibles par deux au lieu d’un pour indiquer plus précisément le nombre de broches qui peuvent être créées avec les ressources restantes.

Le processus est inversé lorsqu’un flux « lourd » est fermé. Le nombre de broches disponibles peut augmenter de plusieurs pour refléter le fait que deux flux « légers » ou plus peuvent être créés à partir des ressources nouvellement libérées.

Si un pilote miniport ne prend pas en charge l’interface IPinCount, le pilote de port utilise le nombre de broches initialisées statiquement dans le tableau de PCPIN_DESCRIPTOR du filtre.

L’interface IPinCount fournit une méthode unique. Le pilote de port lié au pilote miniport appelle cette méthode en réponse à une requête de nombre d’épingles.

Héritage

L’interface IPinCount hérite de l’interface IUnknown.

Méthode

L’interface IPinCount possède ces méthodes.

IPinCount ::P inCount La méthode PinCount interroge le pilote miniport pour son nombre d’épingles.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	portcls.h