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 come pin vengono creati e chiusi. Questa interfaccia viene implementata nel driver miniport. Per determinare se un driver miniport supporta questa interfaccia, il driver di porta chiama il metodo QueryInterface dell'oggetto miniport con IID_IPinCount REFIID. IPinCount eredita dall'interfaccia IUnknown .

I driver di porta seguenti useranno un'interfaccia del IPinCount 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 o entrambe le operazioni seguenti:

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

Nel caso di un dispositivo audio a 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 usate.

Quando si apre un flusso "heavyweight", il driver miniport potrebbe dover decrerere il conteggio dei pin disponibili per due anziché per 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 conteggio dei 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 statici 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.

Ereditarietà

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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portcls.h