Pin Category (propiedad)

Los controladores de audio de Microsoft Windows Driver Model (WDM) para dispositivos de audio USB, dispositivos de audio IEEE 1394 y dispositivos de audio en buses internos representan todos sus dispositivos como filtros KS con patillas. Un controlador de audio WDM mantiene una estructura KSPIN_DESCRIPTOR para cada tipo de patilla que admita. Dentro de esta estructura, el controlador almacena las propiedades KSPROPSETID_Pin del tipo de patilla. Entre esas propiedades se encuentra la propiedad KSPROPERTY_PIN_CATEGORY . Una solicitud de esta propiedad recupera el GUID de categoría de patilla 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 patilla determinado, KSNODETYPE_HEADPHONES, identifica una patilla como un conector 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 patilla, cada uno de los cuales describe un tipo de patilla en el filtro que representa el dispositivo. Cada descriptor de patilla es una estructura PCPIN_DESCRIPTOR que contiene una estructura de KSPIN_DESCRIPTOR incrustada con un GUID de categoría de patilla. Al recibir una solicitud de propiedad de KSPROPERTY_PIN_CATEGORY de un cliente, el controlador de puerto recupera el GUID de categoría de patilla del controlador de minipuerto para el tipo de patilla especificado. Para obtener más información sobre los descriptores de patillas, vea Factorías de patillas.

Un dispositivo de audio USB tiene un 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 clase USBAudio traduce los terminales del dispositivo en patillas 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 patilla correspondientes.

Tipos de terminales de entrada

Id. de terminal USB	GUID de categoría de patilla KS
0x0201	KSNODETYPE_MICROPHONE
0x0202	KSNODETYPE_DESKTOP_MICROPHONE
0x0203	KSNODETYPE_PERSONAL_MICROPHONE
0x0204	KSNODETYPE_OMNI_DIRECTIONAL_MICROPHONE
0x0205	KSNODETYPE_MICROPHONE_ARRAY
0x0206	KSNODETYPE_PROCESSING_MICROPHONE_ARRAY

Tipos de terminal de salida

Id. de terminal USB	GUID de categoría de patilla KS
0x0301	KSNODETYPE_SPEAKER
0x0302	KSNODETYPE_HEADPHONES
0x0303	KSNODETYPE_HEAD_MOUNTED_DISPLAY_AUDIO
0x0304	KSNODETYPE_DESKTOP_SPEAKER
0x0305	KSNODETYPE_ROOM_SPEAKER
0x0306	KSNODETYPE_COMMUNICATION_SPEAKER
0x0307	KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Tipos de terminal bidireccionales

Id. de terminal USB	GUID de categoría de patilla KS
0x0401	KSNODETYPE_HANDSET
0x0402	KSNODETYPE_HEADSET
0x0403	KSNODETYPE_SPEAKERPHONE_NO_ECHO_REDUCTION
0x0404	KSNODETYPE_ECHO_SUPPRESSING_SPEAKERPHONE
0x0405	KSNODETYPE_ECHO_CANCELING_SPEAKERPHONE

Tipos de terminal de telefonía

Id. de terminal USB	GUID de categoría de patilla KS
0x0501	KSNODETYPE_PHONE_LINE
0x0502	KSNODETYPE_TELEPHONE
0x0503	KSNODETYPE_DOWN_LINE_PHONE

Tipos de terminal externo

Id. de terminal USB	GUID de categoría de patilla KS
0x0601	KSNODETYPE_ANALOG_CONNECTOR
0x0602	KSNODETYPE_DIGITAL_AUDIO_INTERFACE
0x0603	KSNODETYPE_LINE_CONNECTOR
0x0604	KSNODETYPE_LEGACY_AUDIO_CONNECTOR
0x0605	KSNODETYPE_SPDIF_INTERFACE
0x0606	KSNODETYPE_1394_DA_STREAM
0x0607	KSNODETYPE_1394_DV_STREAM_SOUNDTRACK

Tipos de terminal de funciones insertadas

Id. de terminal USB	GUID de categoría de patillas KS
0x0701	KSNODETYPE_LEVEL_CALIBRATION_NOISE_SOURCE
0x0702	KSNODETYPE_EQUALIZATION_NOISE
0x0703	KSNODETYPE_CD_PLAYER
0x0704	KSNODETYPE_DAT_IO_DIGITAL_AUDIO_TAPE
0x0705	KSNODETYPE_DCC_IO_DIGITAL_COMPACT_CASSETTE
0x0706	KSNODETYPE_MINIDISK
0x0707	KSNODETYPE_ANALOG_TAPE
0x0708	KSNODETYPE_PHONOGRAPH
0x0709	KSNODETYPE_VCR_AUDIO
0x070A	KSNODETYPE_VIDEO_DISC_AUDIO
0x070B	KSNODETYPE_DVD_AUDIO
0x070C	KSNODETYPE_TV_TUNER_AUDIO
0x070D	KSNODETYPE_SATELLITE_RECEIVER_AUDIO
0x070E	KSNODETYPE_CABLE_TUNER_AUDIO
0x070F	KSNODETYPE_DSS_AUDIO
0x0710	KSNODETYPE_RADIO_RECEIVER
0x0711	KSNODETYPE_RADIO_TRANSMITTER
0x0712	KSNODETYPE_MULTITRACK_RECORDER
0x0713	KSNODETYPE_SYNTHESIZER

Para obtener más información sobre los identificadores de tipo de terminal USB, vea 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 patillas de las tablas anteriores tienen nombres de parámetro del formulario 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 algunas posibilidades de confusión entre los GUID de categoría de patillas y los 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 puede identificar una categoría de patillas o un tipo de nodo, en función del contexto. Para obtener una lista de los GUID de tipo de nodo, consulte Nodos de topología de audio.

Al crear instancias 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 del 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 de patillas 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 pin 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 pin personalizado solo es útil para los clientes que reconocen el GUID.

El subsistema de audio mantiene una lista de GUID de categoría de patillas y sus nombres descriptivos 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 patillas para asociar nombres descriptivos a dispositivos de punto de conexión de audio. Para obtener más información sobre cómo asociar nombres descriptivos con dispositivos de punto de conexión de audio, consulte Nombres descriptivos para dispositivos de punto de conexión de audio.