Épingles de topologie
Le pilote système WDMAud traduit les broches de topologie sur les filtres KS en lignes de mélangeur source et de destination que l’API mixer expose aux applications. Les broches d’entrée (récepteur) deviennent des lignes de mélangeur source, et les broches de sortie (source) deviennent des lignes de mélangeur de destination.
Comme décrit dans Fabriques de broches, un pilote miniport fournit un tableau de descripteurs de broches, chacun d’eux étant une structure de type PCPIN_DESCRIPTOR qui décrit une fabrique de broches appartenant à un filtre. Chaque descripteur d’épingle inclut les informations suivantes :
Spécificateur de direction de flux de données
Indique si le flux de données entre (KSPIN_DATAFLOW_IN) ou quitte (KSPIN_DATAFLOW_OUT) le filtre via l’épingle.
GUID de catégorie de broche KS
Indique la catégorie d’épingle à laquelle appartient l’épingle. Par exemple, sur un périphérique de lecture audio, une broche peut accepter un flux audio numérique au format onde, et une autre broche peut générer un signal audio analogique pour piloter un haut-parleur. Le pilote miniport identifie ces deux types de broches comme appartenant à des catégories de broches distinctes.
Spécificateur de type de communication
Indique le type de communications IRP que l’épingle prend en charge. Une broche qui prend en charge les communications IRP peut être un récepteur IRP (KSPIN_COMMUNICATION_SINK), une source IRP (KSPIN_COMMUNICATION_SOURCE) ou les deux (KSPIN_COMMUNICATION_BOTH). Une broche qui ne prend pas en charge les communications IRP peut se trouver à l’intérieur d’un graphique de filtre KS (KSPIN_COMMUNICATION_NONE) ou être une broche de pont au point de terminaison d’un graphique (KSPIN_COMMUNICATION_BRIDGE).
Pour plus d’informations sur les broches de pont, consultez Graphiques de filtre audio.
WDMAud convertit les informations du descripteur de broche du pilote miniport en un descripteur de ligne de mélangeur, qui est une structure de type MIXERLINE qui inclut les informations suivantes :
Type de composant mixer-line
Indique si la ligne du mélangeur est une ligne source ou de destination, et indique également la fonction générale de la ligne de mélangeur. Par exemple, le type de composant d’une ligne de mixage qui transporte un signal analogique généré à partir d’un flux de sortie d’onde (rendu) pour piloter un ensemble de casques est MIXERLINE_COMPONENTTYPE_DST_HEADPHONES.
Type de cible de ligne de mélange
Indique le type de flux de données que la ligne de mélangeur transporte. Par exemple, le type cible d’un flux de sortie d’onde (rendu) est MIXERLINE_TARGETTYPE_WAVEOUT, et le type cible d’un flux d’entrée d’onde (capture) est MIXERLINE_TARGETTYPE_WAVEIN.
Pour plus d’informations, consultez la structure MIXERLINE dans la documentation du Kit de développement logiciel (SDK).
Les deux tableaux suivants montrent comment WDMAud traduit les lignes de mixage sources d’entrée (KSPIN_DATAFLOW_IN).
Le premier tableau montre comment les GUID de la catégorie de broche KS d’entrée (valeurs PCPIN_DESCRIPTOR) sont mappés aux types de cibles MIXERLINE associés.
| GUID de catégorie de broche KS | Broche de pont ? | Type de cible MIXERLINE |
|---|---|---|
| KSNODETYPE_MICROPHONE | - | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_DESKTOP_MICROPHONE | - | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_LEGACY_AUDIO_CONNECTOR | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSCATEGORY_AUDIO | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_SPEAKER | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_CD_PLAYER | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_SYNTHESIZER | - | MIXERLINE_TARGETTYPE_MIDIOUT |
| KSNODETYPE_LINE_CONNECTOR | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_TELEPHONE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_PHONE_LINE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_DOWN_LINE_PHONE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_ANALOG_CONNECTOR | Yes | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_ANALOG_CONNECTOR | No | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_SPDIF_INTERFACE | Yes | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_SPDIF_INTERFACE | No | MIXERLINE_TARGETTYPE_WAVEOUT |
Le tableau suivant montre comment les GUID de catégorie de broche KS d’entrée sont mappés aux types de composants MIXERLINE associés.
| PCPIN_DESCRIPTOR valeurs | Valeurs MIXERLINE |
|---|---|
| GUID de catégorie de broche KS | Type de composant |
KSNODETYPE_MICROPHONE KSNODETYPE_DESKTOP_MICROPHONE |
MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE |
KSNODETYPE_LEGACY_AUDIO_CONNECTOR KSCATEGORY_AUDIO KSNODETYPE_SPEAKER |
MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT |
KSNODETYPE_CD_PLAYER |
MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC |
KSNODETYPE_SYNTHESIZER |
MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER |
KSNODETYPE_LINE_CONNECTOR |
MIXERLINE_COMPONENTTYPE_SRC_LINE |
KSNODETYPE_TELEPHONE KSNODETYPE_PHONE_LINE KSNODETYPE_DOWN_LINE_PHONE |
MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE |
KSNODETYPE_ANALOG_CONNECTOR |
MIXERLINE_COMPONENTTYPE_SRC_ANALOG |
KSNODETYPE_ANALOG_CONNECTOR |
MIXERLINE_COMPONENTTYPE_SRC_ANALOG |
KSNODETYPE_SPDIF_INTERFACE |
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL |
KSNODETYPE_SPDIF_INTERFACE |
MIXERLINE_COMPONENTTYPE_SRC_DIGITAL |
Dans les tableaux précédents, la colonne de gauche spécifie le GUID de catégorie de broche à partir de la structure PCPIN_DESCRIPTOR de la broche, et les colonnes de droite spécifient le type cible et le type de composant correspondants pour la structure MIXERLINE.
Les entrées de la colonne intitulée « Broche de pont ? » indiquent si la broche est une broche de pont. Un « Oui » signifie que le type de communication de broche est KSPIN_COMMUNICATION_BRIDGE. Un « Non » signifie que le type de communication de broche est une valeur KSPIN_COMMUNICATION_Xxx autre que KSPIN_COMMUNICATION_BRIDGE. Si WDMAud ignore le type de communication de broche lors de la traduction des paramètres de broche en paramètres de ligne de mixage, l’entrée « Broche de pont ? » est un tiret (-).
Pour toutes les catégories de broches qui n’apparaissent pas dans les tableaux précédents, WDMAud convertit les broches d’entrée en lignes de mélangeur sources avec des types cibles d’MIXERLINE_TARGETTYPE_UNDEFINED et de composants de MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED.
Les tableaux suivants montrent comment WDMAud traduit les broches de sortie (KSPIN_DATAFLOW_OUT) en lignes de mélangeur de destination. Les en-têtes de colonne ont les mêmes significations que dans le tableau précédent. Le premier tableau montre comment les GUID de catégorie de broche KS de sortie sont mappés aux types cibles MIXERLINE associés.
| GUID de catégorie de broche KS | Broche de pont ? | Type cible MIXERLINE |
|---|---|---|
| KSNODETYPE_SPEAKER | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_DESKTOP_SPEAKER | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_ROOM_SPEAKER | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_COMMUNICATION_SPEAKER | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSCATEGORY_AUDIO | - | MIXERLINE_TARGETTYPE_WAVEIN |
| PINNAME_CAPTURE | - | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_HEADPHONES | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_HEAD_MOUNTED_DISPLAY_AUDIO | - | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_TELEPHONE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_PHONE_LINE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_DOWN_LINE_PHONE | - | MIXERLINE_TARGETTYPE_UNDEFINED |
| KSNODETYPE_ANALOG_CONNECTOR | Yes | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_ANALOG_CONNECTOR | No | MIXERLINE_TARGETTYPE_WAVEIN |
| KSNODETYPE_SPDIF_INTERFACE | Yes | MIXERLINE_TARGETTYPE_WAVEOUT |
| KSNODETYPE_SPDIF_INTERFACE | No | MIXERLINE_TARGETTYPE_WAVEIN |
Le tableau suivant montre comment les GUID de catégorie de broche KS de sortie sont mappés aux types de composants MIXERLINE associés.
| PCPIN_DESCRIPTOR valeurs | Valeurs MIXERLINE |
|---|---|
| GUID de catégorie de broche KS | Type de composant |
KSNODETYPE_SPEAKER KSNODETYPE_DESKTOP_SPEAKER KSNODETYPE_ROOM_SPEAKER KSNODETYPE_COMMUNICATION_SPEAKER |
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS |
KSCATEGORY_AUDIO PINNAME_CAPTURE |
MIXERLINE_COMPONENTTYPE_DST_WAVEIN |
KSNODETYPE_HEADPHONES KSNODETYPE_HEAD_MOUNTED_DISPLAY_AUDIO |
MIXERLINE_COMPONENTTYPE_DST_HEADPHONES |
KSNODETYPE_TELEPHONE KSNODETYPE_PHONE_LINE KSNODETYPE_DOWN_LINE_PHONE |
MIXERLINE_COMPONENTTYPE_DST_TELEPHONE |
KSNODETYPE_ANALOG_CONNECTOR |
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS |
KSNODETYPE_ANALOG_CONNECTOR |
MIXERLINE_COMPONENTTYPE_DST_WAVEIN |
KSNODETYPE_SPDIF_INTERFACE |
MIXERLINE_COMPONENTTYPE_DST_SPEAKERS |
KSNODETYPE_SPDIF_INTERFACE |
MIXERLINE_COMPONENTTYPE_DST_WAVEIN |
Pour toutes les catégories de broches qui n’apparaissent pas dans les tableaux précédents, WDMAud traduit les broches de sortie en lignes de mélangeur de destination avec les types cibles de MIXERLINE_TARGETTYPE_UNDEFINED et les types de composants de MIXERLINE_COMPONENTTYPE_DST_UNDEFINED.
Dans les tableaux précédents, la plupart des GUID de catégorie de broches KS ont des noms KSNODETYPE_Xxx . Ces noms sont définis dans les fichiers d’en-tête Ksmedia.h et Dmusprop.h. (Deux écarts par rapport à cette convention de nommage sont les GUID KSCATEGORY_AUDIO et PINNAME_CAPTURE, qui sont également définis dans Ksmedia.h.) Comme décrit dans Nœuds de topologie, les GUID KSNODETYPE_Xxx peuvent également être utilisés pour désigner des types de nœuds KS. La plupart des GUID KSNODETYPE_Xxx spécifient des catégories de broches ou des types de nœuds, mais pas les deux. L’exception est KSNODETYPE_SYNTHESIZER, qui peut spécifier une catégorie de broche ou un type de nœud, en fonction du contexte dans lequel est utilisé. Pour obtenir la liste des GUID de KSNODETYPE_Xxx représentant des catégories de broches, consultez Pin Category Property. Pour obtenir la liste des GUID KSNODETYPE_Xxx représentant les types de nœuds, consultez Nœuds de topologie audio.
KSCATEGORY_AUDIO est un autre GUID à double utilisation. Il peut être utilisé comme GUID de catégorie de broche KS ou GUID de catégorie de filtre KS, en fonction du contexte. Pendant l’installation de l’appareil, un pilote audio inscrit son interface d’appareil sous la catégorie de filtre KSCATEGORY_AUDIO. Pour plus d’informations, consultez Installation d’interfaces d’appareil pour une carte audio.
Pour une catégorie de broche de KSNODETYPE_ANALOG_CONNECTOR ou de KSNODETYPE_SPDIF_INTERFACE, WDMAud doit savoir si la broche est une broche de pont pour traduire correctement la broche en son équivalent de ligne de mélangeur. Par exemple, une broche S/PDIF (avec la catégorie de broche KSNODETYPE_SPDIF_INTERFACE) se traduit par l’un des quatre types de lignes de mélangeur illustrés dans la figure suivante. La traduction dépend à la fois de la direction des données de la broche (in ou out) et du fait qu’il s’agit d’une broche de pont (oui ou non), qui donnent ensemble quatre types possibles de ligne de mélangeur (in+yes, in+no, out+yes et out+no). Les quatre types de lignes de mélangeur indiqués dans la figure représentent les paires inférieures d’entrées des tableaux précédents.
Notez que deux flux sur le côté droit de l’appareil audio dans la figure sont au format S/PDIF, et les deux flux à gauche sont au format wave. Le périphérique audio effectue la conversion entre les deux formats numériques.
L’application SndVol32 est un client de l’API mixer. L’API mixer convertit chaque broche trouvée dans la topologie en une ligne de mélangeur source ou de destination, mais la ligne peut ne pas s’afficher dans SndVol32, qui reconnaît uniquement un sous-ensemble des types de composants de ligne de mélange que le fichier d’en-tête Mmsystem.h définit pour l’API de mélangeur. Pour plus d’informations sur SndVol32, consultez SysTray et SndVol32.