struttura PCPIN_DESCRIPTOR (portcls.h)

Articolo
08/07/2023

La struttura PCPIN_DESCRIPTOR descrive una factory di pin.

Sintassi

typedef struct {
  ULONG                    MaxGlobalInstanceCount;
  ULONG                    MaxFilterInstanceCount;
  ULONG                    MinFilterInstanceCount;
  const PCAUTOMATION_TABLE *AutomationTable;
  KSPIN_DESCRIPTOR         KsPinDescriptor;
} PCPIN_DESCRIPTOR, *PPCPIN_DESCRIPTOR;

Members

MaxGlobalInstanceCount

Specifica il numero massimo globale di istanze di questo tipo di pin. Il numero massimo globale conta il numero di istanze del pin che il driver dell'adattatore può supportare in tutte le istanze del filtro. Il conteggio può essere impostato su zero per indicare che non è possibile creare un'istanza del pin. Un valore di ULONG(-1) indica che è possibile creare un'istanza del pin per qualsiasi numero di volte. Qualsiasi altro valore indica un numero specifico di volte in cui è possibile creare un'istanza del pin.

MaxFilterInstanceCount

Specifica il numero massimo di istanze del pin in una singola istanza del filtro. Il conteggio può essere impostato su zero per indicare che non è possibile creare un'istanza del pin. Un valore di ULONG(-1) indica che è possibile creare un'istanza del pin per qualsiasi numero di volte. Qualsiasi altro valore indica un numero specifico di volte in cui è possibile creare un'istanza del pin.

MinFilterInstanceCount

Specifica il numero minimo di volte in cui è necessario creare un'istanza del pin in un'istanza del filtro. Questo membro è un limite inferiore definito sul numero di istanze di un pin che deve esistere affinché un filtro possa funzionare.

AutomationTable

Puntatore alla tabella di automazione. Questo membro è un puntatore a una struttura di tipo PCAUTOMATION_TABLE. Il puntatore può essere NULL per indicare che non è supportata alcuna automazione. La tabella di automazione specifica i gestori per le proprietà e gli eventi appartenenti all'istanza del pin.

KsPinDescriptor

Descrive la factory di pin. Questo membro è una struttura di tipo KSPIN_DESCRIPTOR. Una factory di pin può avere zero interfacce e zero medie. L'elenco di interfacce viene ignorato in tutti i casi. L'elenco standard-medio verrà usato per impostazione predefinita in un elenco contenente solo l'I/O del dispositivo (KSMEDIUM_STANDARD_DEVIO).

Commenti

Questa struttura viene usata per descrivere ogni pin factory implementata da un driver miniport. La struttura PCFILTER_DESCRIPTOR del driver contiene un puntatore a una matrice di strutture PCPIN_DESCRIPTOR . Il numero di elementi nella matrice è uguale al numero di pin factory nel filtro.

I membri MaxGlobalInstanceCount, MaxFilterInstanceCount e MinFilterInstanceCount sono conteggi massimi e minimi che descrivono le restrizioni delle risorse e i requisiti funzionali del pin. Una matrice di PCPIN_DESCRIPTOR inizializzata automaticamente può presentare solo una stima statica delle risorse pin disponibili. Il metodo IPinCount::P inCount consente al driver di rivedere dinamicamente l'elenco delle risorse pin disponibili man mano che i pin vengono allocati e liberati.

Il valore MaxGlobalInstanceCount è simile al seguente:

Parametro di chiamata GlobalPossible del metodo PinCount.
Valore della proprietà KSPROPERTY_PIN_GLOBALCINSTANCES (membro PossibleCount della struttura KSPIN_CINSTANCES).

Il valore maxFilterInstanceCount è simile al seguente:

Parametro di chiamata FilterPossible del metodo PinCount.
Valore della proprietà KSPROPERTY_PIN_CINSTANCES (membro PossibleCount della struttura KSPIN_CINSTANCES).

Il valore MinFilterInstanceCount è simile al seguente:

Parametro di chiamata FilterNecessary del metodo PinCount.
Valore della proprietà KSPROPERTY_PIN_NECESSARYINSTANCES .

Quando si descrive un pin di bridge (vedere Grafici filtro audio), impostare MaxGlobalInstanceCount, MaxFilterInstanceCount e MinFilterInstanceCount su zero e impostare AutomationTable su NULL.

Per un semplice esempio di codice che mostra come viene usata la struttura PCPIN_DESCRIPTOR , vedere Esposizione della topologia filtro.

Per altre informazioni, vedere Pin Factory.