Interface IPinCount (portcls.h)

A interface IPinCount fornece um meio para o driver de miniporto monitorar e manipular suas contagens de pinos dinamicamente à medida que os pinos são instanciados e fechados. Essa interface é implementada no driver de miniporto. Para determinar se um driver de miniporto dá suporte a essa interface, o driver de porta chama o método queryInterface do objeto miniport com IID_IPINCOUNTREFIID. IPinCount herda da interface IUnknown.

Os drivers de porta a seguir usarão a interface de IPinCount de um driver de miniporto se o driver de miniporto implementá-la: WaveCyclic, WavePci, MIDI, DMus e Topologia.

IPinCount é uma interface opcional que um driver de miniporto pode dar suporte se precisar fazer um ou ambos os seguintes procedimentos:

• Seja notificado explicitamente sobre as alterações nas contagens de pinos de streaming do kernel.
• Altere dinamicamente suas contagens de pinos.

No caso de um dispositivo de áudio de onda, por exemplo, fluxos com atributos diferentes (3D, estéreo/mono e assim por diante) também podem ter "pesos" diferentes em termos da quantidade de recursos de hardware que consomem.

Ao abrir um fluxo "pesado", o driver de miniporto pode precisar diminuir a contagem de pinos disponível por dois em vez de um para indicar com mais precisão o número de pinos que podem ser criados com os recursos restantes.

O processo é invertido quando um fluxo "pesado" é fechado. A contagem de pinos disponíveis pode aumentar em mais de um para refletir o fato de que dois ou mais fluxos "leves" podem ser criados com base nos recursos recém-liberados.

Se um driver de miniporto não der suporte à interface IPinCount, o driver de porta usará as contagens de pinos inicializadas estaticamente na matriz PCPIN_DESCRIPTOR do filtro.

A interface IPinCount fornece um único método. O driver de porta associado ao driver de miniporto chama esse método em resposta a uma consulta de contagem de pinos.

Herança

A interface IPinCount herda da interface IUnknown.

Métodos

A interface IPinCount tem esses métodos.

IPinCount::P inCount O método PinCount consulta o driver de miniporto para sua contagem de pinos.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	portcls.h