Propiedad de categoría de pin

Los controladores de audio del Modelo de Controladores de Microsoft Windows (WDM) para dispositivos de audio USB, dispositivos de audio IEEE 1394 y dispositivos de audio en buses internos representan sus dispositivos como filtros KS con pines. Un controlador de audio WDM mantiene una estructura KSPIN_DESCRIPTOR para cada tipo de pin que soporta. Dentro de esta estructura, el controlador almacena las propiedades KSPROPSETID_Pin del tipo de pin. Entre esas propiedades se encuentra la propiedad KSPROPERTY_PIN_CATEGORY . Una solicitud para esta propiedad recupera el GUID de categoría de pin KS del miembro Category de la estructura KSPIN_DESCRIPTOR. Este GUID indica la categoría general de funcionalidad que proporciona el pin. Por ejemplo, un GUID de categoría de pines determinado, KSNODETYPE_HEADPHONES, identifica un pin como una toma de salida para auriculares.

En el caso de un dispositivo de audio de onda en un bus interno (por ejemplo, PCI), el controlador de miniporte PortCls contiene una matriz de descriptores de patillas, cada uno de los cuales describe un tipo de patilla en el filtro que representa el dispositivo. Cada descriptor de pin es una estructura PCPIN_DESCRIPTOR que contiene una estructura KSPIN_DESCRIPTOR incrustada con un GUID de categoría de pin. Al recibir una solicitud de propiedad KSPROPERTY_PIN_CATEGORY de un cliente, el controlador de puerto recupera el GUID de categoría de pin del descriptor de pin del miniport driver para el tipo de pin especificado. Para obtener más información sobre los descriptores de pines, vea Fábricas de Pinos.

Un dispositivo de audio USB tiene cierto número de terminales a través de los cuales las secuencias digitales y las señales analógicas pueden entrar y salir del dispositivo. Al construir un filtro KS para representar un dispositivo de audio USB, el controlador del sistema de controladores de clase USBAudio traduce los terminales del dispositivo en pines del filtro. El archivo de encabezado Ksmedia.h define una asignación para cada identificador de tipo de terminal USB a un GUID de categoría de pin KS. En las seis tablas siguientes se muestran los identificadores de tipo de terminal y sus GUID de categoría de pin correspondientes.

Tipos de terminales de entrada

Tipos de terminal de salida

Tipos de terminal bidireccionales

Tipos de terminal de telefonía

Tipos de terminal externo

Tipos de terminales de función incrustados

Para obtener más información sobre los identificadores de tipo de terminal USB, consulte la definición de clase de dispositivo de bus serie universal para los tipos de terminal (versión 1.0), que está disponible en el sitio web del foro de implementadores USB .

Todos los GUID de categoría de pin de las tablas anteriores tienen nombres de parámetro con el formato KSNODETYPE_XXX. Tenga en cuenta que los GUID de tipo de nodo KS también tienen nombres de parámetro KSNODETYPE_XXX . Esta convención de nomenclatura crea potencialmente confusión entre los códigos de identificación únicos (GUID) de categoría de pin y los códigos de identificación únicos (GUID) de tipo de nodo. Afortunadamente, casi todos los parámetros KSNODETYPE_XXX identifican una categoría de patillas o un tipo de nodo, pero no ambos. La única excepción a la regla es KSNODETYPE_SYNTHESIZER, que, en función del contexto, puede identificar una categoría de pines o un tipo de nodo. Para obtener una lista de GUID de tipo nodo, consulte Nodos de topología de audio.

Al crear una instancia de un dispositivo de audio USB, el controlador del sistema de clase USBAudio consulta el dispositivo para su topología interna, incluidos sus terminales. Con esta información, el controlador USBAudio construye un filtro para representar el dispositivo y convierte cada terminal en un pin correspondiente en el filtro. Durante este proceso, el controlador traduce cada identificador de tipo de terminal USB en el GUID de categoría de PIN KS correspondiente, que es uno de los GUID de las tablas anteriores. El controlador construye una estructura KSPIN_DESCRIPTOR para describir el pin y escribe el GUID de categoría del pin en la estructura.

Un controlador de miniporte PortCls no usa necesariamente solo los GUID de categoría que aparecen en las seis tablas anteriores. Por ejemplo, un controlador podría definir y usar un GUID de categoría de patillas personalizado para describir un tipo de patilla cuya categoría funcional se encuentra fuera de las categorías de las tablas. Naturalmente, un GUID de categoría de pines personalizado solo resulta útil para los clientes que reconocen el GUID.

El subsistema de audio mantiene una lista de GUID de categoría de pines y sus nombres amigables asociados en el registro del sistema. El instalador de clase multimedia copia los pares GUID-name en el Registro desde el archivo Ks.inf ubicado en la subcarpeta Inf de la carpeta principal de Windows (por ejemplo, C:\Windows\Inf\Ks.inf).

El sistema operativo usa categorías de pines para asociar nombres amigables a dispositivos de audio de punto final. Para obtener más información sobre cómo asociar nombres descriptivos a dispositivos de punto de conexión de audio, consulte Nombres descriptivos para dispositivos de punto de conexión de audio.