Share via

Interface IPinCount (portcls.h)

  • Artigo

A IPinCount interface 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 miniporta. 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_IPINCOUNT REFIID. IPinCount herda da interface IUnknown .

Os seguintes drivers de porta usarão a interface de um driver de IPinCount miniporto se o driver de miniporto a implementar: WaveCyclic, WavePci, MIDI, DMus e Topology.

IPinCount é uma interface opcional à qual 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 de 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 em dois em vez de por 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 miniporta não der suporte à IPinCount interface , o driver de porta usará as contagens de pinos inicializadas estaticamente na matriz PCPIN_DESCRIPTOR do filtro.

A IPinCount interface 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
Plataforma de Destino Windows
Cabeçalho portcls.h