estructura de PCPIN_DESCRIPTOR (portcls.h)

Artículo
08/07/2023

La estructura PCPIN_DESCRIPTOR describe un generador de patillas.

Sintaxis

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

Miembros

MaxGlobalInstanceCount

Especifica el número máximo global de veces que se puede crear una instancia de este tipo de patilla. El máximo global cuenta el número de instancias de patillas que el controlador del adaptador puede admitir en todas las instancias del filtro. El recuento se puede establecer en cero para indicar que no se puede crear una instancia del pin. Un valor de ULONG(-1) indica que se puede crear una instancia del pin en cualquier número de veces. Cualquier otro valor indica un número específico de veces que se puede crear una instancia del pin.

MaxFilterInstanceCount

Especifica el número máximo de veces que se puede crear una instancia del pin en una sola instancia del filtro. El recuento se puede establecer en cero para indicar que no se puede crear una instancia del pin. Un valor de ULONG(-1) indica que se puede crear una instancia del pin en cualquier número de veces. Cualquier otro valor indica un número específico de veces que se puede crear una instancia del pin.

MinFilterInstanceCount

Especifica el número mínimo de veces que se debe crear una instancia del pin en una instancia del filtro. Este miembro es un límite inferior definido en el número de instancias de un pin que debe existir para que un filtro pueda funcionar.

AutomationTable

Puntero a la tabla de automatización. Este miembro es un puntero a una estructura de tipo PCAUTOMATION_TABLE. El puntero puede ser NULL para indicar que no se admite ninguna automatización. La tabla de automatización especifica los controladores de las propiedades y eventos que pertenecen a la instancia de anclaje.

KsPinDescriptor

Describe el generador de patillas. Este miembro es una estructura de tipo KSPIN_DESCRIPTOR. Un generador de patillas puede tener cero interfaces y cero medios. La lista de interfaces se omite en todos los casos. La lista estándar de medios tendrá como valor predeterminado una lista que contenga solo E/S del dispositivo (KSMEDIUM_STANDARD_DEVIO).

Comentarios

Esta estructura se usa para describir cada una de las fábricas de patillas que implementa un controlador de minipuerto. La estructura PCFILTER_DESCRIPTOR del controlador contiene un puntero a una matriz de estructuras de PCPIN_DESCRIPTOR . El número de elementos de la matriz es igual al número de generadores de patillas del filtro.

Los miembros MaxGlobalInstanceCount, MaxFilterInstanceCount y MinFilterInstanceCount son recuentos máximos y mínimos que describen las restricciones de recursos del pin y los requisitos funcionales. Una matriz de PCPIN_DESCRIPTOR inicializada automáticamente solo puede presentar una estimación estática de los recursos de anclaje disponibles. El método IPinCount::P inCount proporciona un medio para que el controlador revise su lista de recursos de anclaje disponibles dinámicamente a medida que se asignan y liberan las patillas.

El valor MaxGlobalInstanceCount es similar en sentido a:

Parámetro de llamada GlobalPossible del método PinCount.
Valor de la propiedad KSPROPERTY_PIN_GLOBALCINSTANCES (miembro PossibleCount de la estructura KSPIN_CINSTANCES).

El valor MaxFilterInstanceCount es similar en lo que se refiere a:

Parámetro de llamada FilterPossible del método PinCount.
Valor de la propiedad KSPROPERTY_PIN_CINSTANCES (miembro PossibleCount de la estructura KSPIN_CINSTANCES).

El valor MinFilterInstanceCount es similar en sentido a:

Parámetro de llamada FilterNecessary del método PinCount.
Valor de la propiedad KSPROPERTY_PIN_NECESSARYINSTANCES.

Al describir un pin de puente (vea Gráficos de filtros de audio), establezca MaxGlobalInstanceCount, MaxFilterInstanceCount y MinFilterInstanceCount en cero y establezca AutomationTable en NULL.

Para obtener un ejemplo de código sencillo que muestra cómo se usa la estructura de PCPIN_DESCRIPTOR , vea Exponer topología de filtro.

Para obtener más información, consulte Pin Factorys.