Propriedade de categoria de pino

Os drivers de áudio do Microsoft Windows Driver Model (WDM) para dispositivos de áudio USB, dispositivos de áudio IEEE 1394 e dispositivos de áudio em barramentos internos representam os seus dispositivos como filtros KS com pinos. Um driver de áudio WDM mantém uma estrutura KSPIN_DESCRIPTOR para cada tipo de pin suportado. Dentro dessa estrutura, o driver armazena as propriedades KSPROPSETID_Pin do tipo de pino. Entre essas propriedades está a propriedade KSPROPERTY_PIN_CATEGORY. Uma solicitação para esta propriedade recupera o GUID da categoria de pin KS do membro Category da estrutura KSPIN_DESCRIPTOR. Este GUID indica a categoria geral de funcionalidade que o pino fornece. Por exemplo, um GUID de categoria de pino específico, KSNODETYPE_HEADPHONES, identifica um pino como uma tomada de saída para fones de ouvido.

No caso de um dispositivo de áudio wave em um barramento interno (por exemplo, PCI), o driver de miniporta PortCls contém uma matriz de descritores de pinos, cada um dos quais descreve um tipo de pino no filtro que representa o dispositivo. Cada descritor de pinos é uma estrutura PCPIN_DESCRIPTOR contendo uma estrutura KSPIN_DESCRIPTOR incorporada com um GUID de categoria de pinos. Ao receber uma solicitação de propriedade KSPROPERTY_PIN_CATEGORY de um cliente, o controlador de porta recupera o GUID da categoria de pino do descritor de pino do controlador de miniporta do tipo de pino especificado. Para obter mais informações sobre descritores de pinos, consulte Pin Factories.

Um dispositivo de áudio USB tem algum número de terminais através dos quais fluxos digitais e sinais analógicos podem entrar e sair do dispositivo. Ao construir um filtro KS para representar um dispositivo de áudio USB, o driver do sistema de classe USBAudio traduz os terminais do dispositivo em pinos no filtro. O arquivo de cabeçalho Ksmedia.h define um mapeamento para cada identificador de tipo de terminal USB para um GUID de categoria de pino KS. As seis tabelas a seguir mostram os identificadores de tipo de terminal e seus GUIDs de categoria de pinos correspondentes.

Tipos de terminais de entrada

Tipos de terminais de saída

Tipos de terminais bidirecionais

Tipos de terminais de telefonia

Tipos de terminais externos

Tipos de terminais de função incorporados

Para obter mais informações sobre identificadores de tipo de terminal USB, consulte a Definição de classe de dispositivo de barramento serial universal para tipos de terminal (versão 1.0), disponível no site do Fórum de implementadores USB .

Todos os GUIDs de categoria de pinos nas tabelas anteriores têm nomes de parâmetros do formato KSNODETYPE_XXX. Observe que os GUIDs do tipo de nó KS também têm nomes de parâmetros KSNODETYPE_XXX. Essa convenção de nomenclatura cria algum potencial para confusão entre GUIDs de categoria de pino e GUIDs de tipo de nó. Felizmente, quase todos os parâmetros KSNODETYPE_XXX identificam uma categoria de pino ou um tipo de nó, mas não ambos. A única exceção à regra é KSNODETYPE_SYNTHESIZER, que pode identificar uma categoria de pino ou um tipo de nó, dependendo do contexto. Para obter uma lista de GUIDs de tipo de nó, consulte Nós de topologia de áudio.

Ao instanciar um dispositivo de áudio USB, o driver de sistema de classe USBAudio consulta o dispositivo para sua topologia interna, incluindo seus terminais. Com essas informações, o driver USBAudio constrói um filtro para representar o dispositivo e traduz cada terminal em um pino correspondente no filtro. Durante esse processo, o driver traduz cada identificador de tipo de terminal USB para o GUID correspondente da categoria de pinos KS, que é um dos GUIDs nas tabelas anteriores. O driver constrói uma estrutura KSPIN_DESCRIPTOR para descrever o pino e grava o GUID da categoria de pino na estrutura.

Um driver de miniporta PortCls não usa necessariamente apenas os GUIDs de categoria que aparecem nas seis tabelas anteriores. Por exemplo, um driver pode definir e utilizar um GUID de categoria de pino personalizado para descrever um tipo de pino cuja categoria funcional não se enquadra nas categorias apresentadas nas tabelas. Naturalmente, um GUID de categoria de pino personalizado é útil apenas para clientes que reconhecem o GUID.

O subsistema de áudio mantém no registo do sistema uma lista de GUIDs de categoria de pinos e os seus respetivos nomes comuns. O instalador de classe de mídia copia os pares nome-GUID para o registro a partir do arquivo Ks.inf localizado na subpasta Inf da pasta principal do Windows (por exemplo, C:\Windows\Inf\Ks.inf).

O sistema operativo usa categorias de pinos para associar nomes amigáveis a terminais de áudio. Para obter mais informações sobre como associar nomes amigáveis a dispositivos de ponto de extremidade de áudio, consulte Nomes amigáveis para dispositivos de ponto de extremidade de áudio.