structure KSJACK_DESCRIPTION

  • Article

La structure KSJACK_DESCRIPTION spécifie les attributs physiques d’une prise audio.

Syntaxe

typedef struct {
  DWORD              ChannelMapping;
  DWORD              Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

Membres

ChannelMapping
Spécifie le mappage des canaux audio aux positions correspondantes de l’orateur. ChannelMapping est un masque de bits des indicateurs 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.

Notes

 Devicetopology.h a initialement défini ChannelMapping comme énumération de type EChannelMapping. L’énumération EChannelMapping a depuis été déconseillée et n’est plus utilisée dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.

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

Géolocalisation
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

Prise et emplacement pour un appareil intégré

ePortConnUnknown

Unknown

IsConnected
Indique si un appareil externe est connecté à la prise. Si le contrôleur audio prend en charge la détection de prise sur cette broche, la valeur de IsConnected doit indiquer avec précision si la prise est occupée par une prise à un moment donné. Cette valeur doit toujours être définie sur TRUE pour les appareils qui ne prennent pas en charge la détection de prise.

Remarques

Cette structure est utilisée par la propriété KSPROPERTY_JACK_DESCRIPTION dans Windows Vista et versions ultérieures. Il 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 une prise ou le débrancher d’une prise, une application audio peut utiliser les informations descriptives de la structure pour aider l’utilisateur à trouver la prise.

Lorsqu’un périphérique audio n’expose pas de prise 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 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 prise jack accessible.

Configuration requise

En-tête

 Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3