structure ACX_JACK_DESCRIPTION (acxpin.h)
La structure ACX_JACK_DESCRIPTION décrit les attributs d’une prise audio, tels que 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 de l’orateur. 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 jack. La couleur est exprimée sous la forme d’une valeur RVB 32 bits formée par concaténation des composants de couleur 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, ce qui représente le noir.
ConnectionType
Spécifie le type de connexion physique pour cette prise 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 | Unknown |
| eConnType3Point5mm | Minijack 3,5 mm |
| eConnTypeQuarter | Jack 1/4 pouce |
| eConnTypeAtapiInternal | Connecteur interne ATAPI |
| eConnTypeRCA | Prise 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 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 | Rear |
| eGeoLocFront | Front |
| eGeoLocLeft | Gauche |
| eGeoLocRight | Right |
| eGeoLocTop | Haut |
| eGeoLocBottom | Bas |
| eGeoLocRearPanel | Volet arrière ouvrant ou pull-open |
| eGeoLocRiser | Carte riser |
| eGeoLocInsideMobileLid | 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 | Non applicable. Consultez la section Remarques . |
GenLocation
Spécifie l’emplacement général de la prise 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 | À l’intérieur du châssis principal |
| eGenLocSeparate | Sur un châssis distinct |
| eGenLocOther | Autre emplacement |
PortConnection
Spécifie le type de port représenté par la prise 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 | Jack |
| ePortConnIntegratedDevice | Emplacement pour un appareil intégré |
| ePortConnBothIntegratedAndJack | Une prise jack et un emplacement pour un appareil intégré |
| ePortConnUnknown | Unknown |
Remarques
Cette structure décrit une prise audio qui fait partie d’une connexion entre un périphérique de point de terminaison et un périphérique matériel dans une carte audio. Lorsqu’un utilisateur doit connecter un appareil de point de terminaison à une prise jack ou le débrancher d’une prise jack, une application audio peut utiliser les informations descriptives de la structure pour aider l’utilisateur à trouver la prise jack.
Lorsqu’un périphérique audio n’expose pas de prise jack accessible physiquement, le périphérique audio utilise la valeur eGeoLocNotApplicable pour indiquer aux applications Windows et Windows qu’il n’existe pas de prise jack physique. Par conséquent, il n’y a pas non plus d’emplacement géométrique. Par exemple, le périphérique audio peut être intégré à la carte mère, sans aucune prise jack accessible.
Configuration requise d’ACX
Version minimale d’ACX : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxpin.h |