estrutura PCNODE_DESCRIPTOR (portcls.h)

Artigo
08/07/2023

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

Defina 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 para as 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ó em Nós de Topologia de Áudio.

Name

Ponteiro para um GUID que representa o nome desse nó de topologia. Esse GUID é especificado em um KSPROPERTY_TOPOLOGY_NAMEsolicitação get-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 membro Type deve ser usado para determinar o nome do nó.

Comentários

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

Por exemplo, se um filtro contiver um único nó SOMA, o membro Type desse nó apontará para o valor guid KSNODETYPE_SUM e o membro Name será definido como NULL. Quando consultada para o nome desse nó, a propriedade KSPROPERTY_TOPOLOGY_NAME , depois de determinar que o valor nome do nó é NULL, recupera a cadeia de caracteres de nome da entrada do Registro para o GUID de KSNODETYPE_SUM. No entanto, o mesmo filtro pode conter vários nós de volume, nesse caso, os valores de Tipo para esses nós apontam para o mesmo valor GUID, KSNODETYPE_VOLUME e o valor Nome deve identificar exclusivamente cada um dos nós de volume. O valor Nome do 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 esse GUID contém a cadeia de caracteres de nome que a propriedade KSPROPERTY_TOPOLOGY_NAME recupera para o nó.