estructura de PCFILTER_DESCRIPTOR (portcls.h)

Artículo
02/26/2024

La estructura de PCFILTER_DESCRIPTOR describe la implementación de un controlador de minipuerto de un filtro. La estructura especifica las patillas, los nodos, las conexiones y las propiedades del filtro.

Sintaxis

typedef struct {
  ULONG                         Version;
  const PCAUTOMATION_TABLE      *AutomationTable;
  ULONG                         PinSize;
  ULONG                         PinCount;
  const PCPIN_DESCRIPTOR        *Pins;
  ULONG                         NodeSize;
  ULONG                         NodeCount;
  const PCNODE_DESCRIPTOR       *Nodes;
  ULONG                         ConnectionCount;
  const PCCONNECTION_DESCRIPTOR *Connections;
  ULONG                         CategoryCount;
  const GUID                    *Categories;
} PCFILTER_DESCRIPTOR, *PPCFILTER_DESCRIPTOR;

Miembros

Version

Reservado. Inicialice en cero.

AutomationTable

Puntero a la tabla de automatización. Se trata de una estructura de tipo PCAUTOMATION_TABLE. La tabla de automatización especifica los controladores de las propiedades de la instancia de filtro.

PinSize

Especifica el tamaño en bytes de cada elemento de la matriz Pins . Este valor debe ser un múltiplo de ocho y debe ser al menos sizeof(PCPIN_DESCRIPTOR). Los valores más grandes permiten anexar información de descriptores específicos del cliente a descriptores de anclaje.

PinCount

Especifica el número de descriptores de patillas de la matriz Pins .

Pins

Puntero a la matriz de descriptores de patillas. Cada elemento de matriz es una estructura PCPIN_DESCRIPTOR .

NodeSize

Especifica el tamaño en bytes de cada elemento de la matriz Nodes . Este valor debe ser un múltiplo de ocho y debe ser al menos sizeof(PCNODE_DESCRIPTOR). Los valores más grandes permiten anexar información de descriptores específicos del cliente a descriptores de nodo.

NodeCount

Especifica el número de descriptores de nodo en la matriz Nodos .

Nodes

Puntero a la matriz de descriptores de nodo. Cada elemento de matriz es una estructura PCNODE_DESCRIPTOR .

ConnectionCount

Especifica el número de conexiones de la matriz Connections.

Connections

Puntero a la matriz de descriptores de conexiones. Cada elemento de matriz es una estructura PCCONNECTION_DESCRIPTOR .

CategoryCount

Especifica el número de GUID de la matriz Categories .

Categories

Puntero a la matriz de GUID que especifica las categorías a las que pertenece el objeto. Consulte la explicación de las categorías de topología en Instalación de interfaces de dispositivo para un adaptador de audio.

Comentarios

Un controlador de puerto obtiene el descriptor de filtro del controlador de minipuerto llamando al método IMiniport::GetDescription . El descriptor de filtro es una estructura de PCFILTER_DESCRIPTOR que describe los pines, nodos, conexiones y propiedades del controlador de miniporte. Para obtener más información, vea Propiedades de filtro, anclaje y nodo.