estrutura PCFILTER_DESCRIPTOR (portcls.h)
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ó.
Requisitos
Requisito | Valor |
---|---|
Cabeçalho | portcls.h (inclua Portcls.h) |