structure ACX_JACK_DESCRIPTION (acxpin.h)

Article
02/06/2025

La structure ACX_JACK_DESCRIPTION décrit les attributs d’une prise audio, comme le type de connexion, l’emplacement physique, etc.

Syntaxe

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

Membres

ChannelMapping

Spécifie le mappage des canaux audio aux positions correspondantes du haut-parleur. channelMapping est un masque de bits des indicateurs de KSAUDIO_SPEAKER_XXX (par exemple, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), qui sont définis dans le fichier d’en-tête Ksmedia.h. channelMapping doit être différent de zéro uniquement pour les broches de rendu analogiques. Pour les broches de capture ou pour les broches de rendu numérique, définissez ce membre sur 0.

Color

Spécifie la couleur du jack. La couleur est exprimée sous la forme d’une valeur RVB 32 bits formée par concaténation des composants bleu, vert et rouge 8 bits. Le composant bleu occupe les 8 bits les moins significatifs (bits 0-7), le composant vert occupe les bits 8-15, et le composant rouge occupe les bits 16-23. Les 8 bits les plus significatifs sont des zéros. Si la couleur du jack est inconnue ou si le connecteur physique n’a aucune couleur identifiable, la valeur de ce membre est 0x00000000, qui représente le noir.

ConnectionType

Spécifie le type de connexion physique pour ce jack. La valeur de ce membre est l’une des valeurs d’énumération EPcxConnectionType indiquées dans le tableau suivant.

Valeur	Type de connecteur
eConnTypeUnknown	Inconnu
eConnType3Point5mm	Minijack 3,5 mm
eConnTypeQuarter	Jack de 1/4 pouces
eConnTypeAtapiInternal	Connecteur interne ATAPI
eConnTypeRCA	Jack RCA
eConnTypeOptical	Connecteur optique
eConnTypeOtherDigital	Connecteur numérique générique
eConnTypeOtherAnalog	Connecteur analogique générique
eConnTypeMultichannelAnalogDIN	Connecteur DIN analogique multicanal
eConnTypeXlrProfessional	Connecteur XLR
eConnTypeRJ11Modem	Connecteur de modem RJ11
eConnTypeCombination	Combinaison de connecteurs

GeoLocation

Emplacement géométrique du jack. La valeur de ce membre est l’une des valeurs d’énumération EPcxGeoLocation indiquées dans le tableau suivant.

Valeur	Emplacement géométrique
eGeoLocRear	Arrière
eGeoLocFront	Devant
eGeoLocLeft	Gauche
eGeoLocRight	Droite
eGeoLocTop	Retour au début
eGeoLocBottom	Fond
eGeoLocRearPanel	Volet arrière ouvert ou pull-open
eGeoLocRiser	Carte riser
eGeoLocInsideMobileLid	À l’intérieur du couvercle de l’ordinateur mobile
eGeoLocDrivebay	Baie de lecteur
eGeoLocHDMI	Connecteur HDMI
eGeoLocOutsideMobileLid	Couvercle extérieur de l’ordinateur mobile
eGeoLocATAPI	Connecteur ATAPI
eGeoLocNotApplicable	Sans objet. Consultez la section Remarques.

GenLocation

Spécifie l’emplacement général du jack. La valeur de ce membre est l’une des valeurs d’énumération EPcxGenLocation indiquées dans le tableau suivant.

Valeur	Emplacement général
eGenLocPrimaryBox	Sur le châssis principal
eGenLocInternal	Châssis principal à l’intérieur
eGenLocSeparate	Sur un châssis distinct
eGenLocOther	Autre emplacement

PortConnection

Spécifie le type de port représenté par le jack. La valeur de ce membre est l’une des valeurs d’énumération EPxcPortConnection indiquées dans le tableau suivant.

Valeur	Type de connexion de port
ePortConnJack	Valet
ePortConnIntegratedDevice	Emplacement pour un appareil intégré
ePortConnBothIntegratedAndJack	Un jack et un emplacement pour un appareil intégré
ePortConnUnknown	Inconnu

Remarques

Cette structure décrit une prise audio qui fait partie d’une connexion entre un appareil de point de terminaison et un périphérique matériel dans une carte audio. Lorsqu’un utilisateur doit brancher un appareil de point de terminaison dans un jack ou le déconnecter d’une prise, une application audio peut utiliser les informations descriptives de la structure pour aider l’utilisateur à trouver la prise.

Lorsqu’un appareil audio n’expose pas de prise physiquement accessible, l’appareil audio utilise la valeur eGeoLocNotApplicable pour indiquer aux applications Windows et Windows qu’il n’y a pas de prise physique. Par conséquent, il n’y a pas d’emplacement géométrique non plus. Par exemple, l’appareil audio peut être intégré à la carte mère, sans prise jack accessible.

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence	Valeur
d’en-tête	acxpin.h

Voir aussi

d’en-tête acxpin.h

Partager via