estrutura PCNODE_DESCRIPTOR (portcls.h)

Artigo
02/07/2025

A estrutura PCNODE_DESCRIPTOR descreve um nó no filtro que um driver de miniporto de topologia implementa.

Sintaxe

typedef struct {
  ULONG                    Flags;
  const PCAUTOMATION_TABLE *AutomationTable;
  const GUID               *Type;
  const GUID               *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;

Membros

Flags

Definido como zero. Nenhum bit de sinalizador está definido no momento.

AutomationTable

Ponteiro para a tabela de automação, que é uma estrutura do tipo PCAUTOMATION_TABLE. Esse membro pode ser definido como NULL para indicar que não há suporte para automação. A tabela de automação especifica os manipuladores das propriedades e eventos que pertencem à instância do nó.

Type

Especifica o tipo de nó. Esse membro é um ponteiro para um GUID que identifica exclusivamente o tipo de nó. Consulte a lista de GUIDs do tipo nó nos nós de topologia de áudio .

Name

Ponteiro para um GUID que representa o nome desse nó de topologia. Esse GUID é especificado em uma solicitação de KSPROPERTY_TOPOLOGY_NAMEget-property para obter a cadeia de caracteres de nome correspondente para o nó. Esse ponteiro pode ser definido como NULL para indicar que o GUID no Type membro deve ser usado para determinar o nome do nó.

Observações

Se um filtro contiver apenas um único nó do tipo especificado pelo membro tipo, o membro Name poderá ser especificado como NULL porque o Type valor é suficiente para identificar exclusivamente o nó dentro do filtro. Se o filtro contiver dois ou mais nós do mesmo tipo, os membros nome para esses nós deverão sernull.

Por exemplo, se um filtro contiver um único nó SUM, o membro tipo desse nó apontará para KSNODETYPE_SUMde valor GUID e o membro nome do será definido como NULL. Quando consultada para o nome desse nó, a propriedade KSPROPERTY_TOPOLOGY_NAME, depois de determinar que o valor nome do do nó é NULL, recupera a cadeia de caracteres de nome da entrada do registro para o GUID do KSNODETYPE_SUM. No entanto, o mesmo filtro pode conter vários nós de volume, caso em que os valores Tipo para esses nós apontam para o mesmo valor GUID, KSNODETYPE_VOLUMEe o valor Name deve identificar exclusivamente cada um dos nós de volume. O Name valor para o nó de controle de volume de entrada de onda, por exemplo, deve apontar para o valor guid KSAUDFNAME_WAVE_IN_VOLUME (definido em ksmedia.h). A entrada do Registro para este GUID contém a cadeia de caracteres de nome que a propriedade KSPROPERTY_TOPOLOGY_NAME recupera para o nó.

A estrutura PCFILTER_DESCRIPTOR contém um ponteiro para uma matriz de estruturas PCNODE_DESCRIPTOR.

Para obter um exemplo de código simples que mostra como a estrutura de PCNODE_DESCRIPTOR é usada, consulte Expondo a topologia de filtro.