estrutura PCFILTER_DESCRIPTOR (portcls.h)

Artigo
08/07/2023

A estrutura PCFILTER_DESCRIPTOR descreve a implementação de um filtro por um driver de miniporte. A estrutura especifica os pinos, os nós, as conexões e as propriedades do filtro.

Sintaxe

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;

Membros

Version

Reservado. Inicialize para zero.

AutomationTable

Ponteiro para a tabela de automação. Essa é uma estrutura do tipo PCAUTOMATION_TABLE. A tabela de automação especifica os manipuladores para as propriedades da instância de filtro.

PinSize

Especifica o tamanho em bytes de cada elemento na matriz Pins . Esse valor deve ser um múltiplo de oito e deve ser pelo menos sizeof(PCPIN_DESCRIPTOR). Valores maiores permitem que informações de descritor específicas do cliente sejam acrescentadas para fixar descritores.

PinCount

Especifica o número de descritores de pin na matriz Pins .

Pins

Ponteiro para a matriz de descritores de pin. Cada elemento de matriz é uma estrutura PCPIN_DESCRIPTOR .

NodeSize

Especifica o tamanho em bytes de cada elemento na matriz Nós . Esse valor deve ser um múltiplo de oito e deve ser pelo menos sizeof(PCNODE_DESCRIPTOR). Valores maiores permitem que informações de descritor específicas do cliente sejam acrescentadas a descritores de nó.

NodeCount

Especifica o número de descritores de nó na matriz Nós .

Nodes

Ponteiro para a matriz de descritores de nó. Cada elemento de matriz é uma estrutura PCNODE_DESCRIPTOR .

ConnectionCount

Especifica o número de conexões na matriz Connections.

Connections

Ponteiro para a matriz de descritores de conexões. Cada elemento de matriz é uma estrutura PCCONNECTION_DESCRIPTOR .

CategoryCount

Especifica o número de GUIDs na matriz Categorias .

Categories

Ponteiro para a matriz de GUIDs que especifica as categorias às quais o objeto pertence. Consulte a discussão de categorias de topologia em Instalando interfaces de dispositivo para um adaptador de áudio.

Comentários

Um driver de porta obtém o descritor de filtro do driver de miniport chamando o método IMiniport::GetDescription . O descritor de filtro é uma estrutura PCFILTER_DESCRIPTOR que descreve os pinos, os nós, as conexões e as propriedades do driver de miniport. Para obter mais informações, consulte Filtrar, fixar e propriedades do nó.