Interfaccia IPinCount (portcls.h)

L'interfaccia IPinCount fornisce un mezzo per il driver miniport per monitorare e modificare il numero di pin in modo dinamico quando vengono create e chiuse istanze dei pin. Questa interfaccia viene implementata nel driver miniport. Per determinare se un driver miniport supporta questa interfaccia, il driver della porta chiama il metodo QueryInterface dell'oggetto miniport con REFIID IID_IPinCount. IPinCount eredita dall'interfaccia di IUnknown.

I driver di porta seguenti useranno un'interfaccia IPinCount del driver miniport se il driver miniport lo implementa: WaveCyclic, WavePci, MIDI, DMus e Topologia.

IPinCount è un'interfaccia facoltativa che un driver miniport può supportare se deve eseguire una o entrambe le operazioni seguenti:

• Ricevere una notifica esplicita delle modifiche apportate ai conteggi dei pin di streaming del kernel.
• Modificare dinamicamente i conteggi dei pin.

Nel caso di un dispositivo audio d'onda, ad esempio, i flussi con attributi diversi (3D, stereo/mono e così via) potrebbero avere anche "pesi" diversi in termini di quantità di risorse hardware utilizzate.

Quando si apre un flusso "heavyweight", il driver miniport potrebbe dover decrementare il numero di pin disponibili di due anziché uno per indicare in modo più accurato il numero di pin che possono essere creati con le risorse rimanenti.

Il processo viene invertito quando viene chiuso un flusso "heavyweight". Il numero di pin disponibili può aumentare di più di uno per riflettere il fatto che due o più flussi "leggeri" possono essere creati dalle risorse appena liberate.

Se un driver miniport non supporta l'interfaccia IPinCount, il driver della porta usa i conteggi dei pin inizializzati staticamente nella matrice di PCPIN_DESCRIPTOR del filtro.

L'interfaccia IPinCount fornisce un singolo metodo. Il driver di porta associato al driver miniport chiama questo metodo in risposta a una query di conteggio dei pin.

Eredità

L'interfaccia IPinCount eredita dall'interfaccia IUnknown.

Metodi

L'interfaccia IPinCount include questi metodi.

IPinCount::P inCount Il metodo PinCount esegue una query sul driver miniport per il conteggio dei pin.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	portcls.h