structure KSJACK_DESCRIPTION

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.

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.

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.

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.

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.

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

Voir aussi

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3