Interface IPinCount (portcls.h)

L’interface IPinCount permet au pilote miniport de surveiller et de manipuler dynamiquement ses nombres de broches à mesure que 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 reFIID IID_IPinCount. IPinCount hérite de l’interface IUnknown .

Les pilotes de port suivants utilisent l’interface d’un IPinCount 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 des opérations suivantes ou les deux :

• Soyez explicitement averti 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 périphérique audio à ondes, par exemple, les flux avec des attributs différents (3D, stéréo/mono, etc.) peuvent également avoir des « poids » différents en termes de quantité de ressources matérielles qu’ils consomment.

Lors de l’ouverture d’un flux « lourd », le pilote miniport peut avoir besoin de décrémenter le nombre de broches disponibles de deux au lieu d’une afin d’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 plus d’un afin de refléter le fait que deux ou plusieurs flux « légers » 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 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 de broches.

Héritage

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

Méthodes

L’interface IPinCount a ces méthodes.

IPinCount ::P inCount La méthode PinCount interroge le pilote miniport pour son nombre de broches.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	portcls.h