Propriété de catégorie de broche

Les pilotes audio du modèle de pilote Microsoft Windows (WDM) pour les périphériques audio USB, les périphériques audio IEEE 1394 et les périphériques audio sur les bus internes représentent tous leurs appareils sous forme de filtres KS avec des broches. Un pilote audio WDM gère une structure KSPIN_DESCRIPTOR pour chaque type de broche qu’il prend en charge. Dans cette structure, le pilote stocke les propriétés du type de broche KSPROPSETID_Pin. Parmi ces propriétés, il s’agit de la propriété KSPROPERTY_PIN_CATEGORY . Une demande de cette propriété récupère le GUID de catégorie de broche KS à partir du membre Catégorie de la structure KSPIN_DESCRIPTOR. Ce GUID indique la catégorie générale de fonctionnalités que fournit la borne. Par exemple, un GUID de catégorie de broche particulier, KSNODETYPE_HEADPHONES, identifie une broche comme une prise de sortie pour les écouteurs.

Dans le cas d’un périphérique audio à ondes sur un bus interne (par exemple, PCI), le pilote miniport PortCls contient un tableau de descripteurs de broche, chacun décrivant un type de broche dans le filtre représentant le périphérique. Chaque descripteur d’épingle est une structure PCPIN_DESCRIPTOR contenant une structure incorporée KSPIN_DESCRIPTOR avec un GUID de catégorie de broche. Lors de la réception d’une demande de propriété KSPROPERTY_PIN_CATEGORY à partir d’un client, le pilote de port récupère le GUID de catégorie de broche à partir du descripteur de broche du pilote miniport pour le type de broche spécifié. Pour plus d’informations sur les descripteurs de broches, consultez Usines de broches.

Un périphérique audio USB a un certain nombre de terminaux par le biais desquels les flux numériques et les signaux analogiques peuvent entrer et quitter l’appareil. Lors de la construction d’un filtre KS pour représenter un périphérique audio USB, le pilote système de classe USBAudio traduit les terminaux du périphérique en broches sur le filtre. Le fichier d’en-tête Ksmedia.h définit un mappage pour chaque identificateur de type de terminal USB avec un GUID de catégorie de broche KS. Les six tableaux suivants affichent les identificateurs de type de terminal et leurs GUID de catégorie d’épingle correspondants.

Types de terminal d’entrée

Types de terminal de sortie

Types de terminal bidirectionnels

Types de terminaux de téléphonie

Types de terminal externe

Types de terminal de fonction incorporés

Pour plus d’informations sur les identificateurs de type de terminal USB, consultez la définition de classe de périphérique Serial Bus universelle pour les types de terminal (version 1.0), qui est disponible sur le site web du Forum des implémenteurs USB .

Tous les GUID de catégorie de broche dans les tables précédentes ont des noms de paramètres de la forme KSNODETYPE_XXX. Notez que les GUID de type de nœud KS ont également des noms de paramètres KSNODETYPE_XXX . Cette convention d’affectation de noms crée une certaine confusion entre les GUID de catégorie d’épingle et les GUID de type de nœud. Heureusement, presque tous les paramètres KSNODETYPE_XXX identifient une catégorie de broche ou un type de nœud, mais pas les deux. L’une des exceptions à la règle est KSNODETYPE_SYNTHESIZER, qui peut identifier une catégorie d’épingle ou un type de nœud, en fonction du contexte. Pour obtenir la liste des GUID de type de nœud, consultez Nœuds de topologie audio.

Lors de l’instanciation d’un périphérique audio USB, le pilote système de classe USBAudio interroge l’appareil pour sa topologie interne, y compris ses terminaux. Avec ces informations, le pilote USBAudio construit un filtre pour représenter l’appareil et traduit chaque terminal en broche correspondante sur le filtre. Pendant ce processus, le pilote traduit chaque identificateur de type de terminal USB en le GUID correspondant à la catégorie de broche KS, qui est l'un des GUID figurant dans les tables précédentes. Le pilote construit une structure KSPIN_DESCRIPTOR pour décrire la broche et écrit le GUID de catégorie de broche dans la structure.

Un pilote miniport PortCls n’utilise pas nécessairement uniquement les GUID de catégorie qui apparaissent dans les six tables précédentes. Par exemple, un pilote peut définir et utiliser un GUID de catégorie de broche personnalisé pour décrire un type d’épingle dont la catégorie fonctionnelle se trouve en dehors des catégories des tables. Naturellement, un GUID de catégorie de pin personnalisé est utile uniquement pour les clients qui reconnaissent le GUID.

Le sous-système audio maintient une liste de GUID de catégorie de broches et leurs noms simplifiés associés dans le registre système. Le programme d’installation de la classe multimédia copie les paires GUID-name dans le Registre à partir du fichier Ks.inf situé dans le sous-dossier Inf du dossier Windows principal (par exemple, C :\Windows\Inf\Ks.inf).

Le système d’exploitation utilise des catégories de broches pour associer des noms d'usage aux dispositifs terminaux audio. Pour plus d’informations sur l’association de noms conviviaux à des appareils de point de terminaison audio, consultez Noms conviviaux pour les appareils de point de terminaison audio.