KSJACK_DESCRIPTION structure (devicetopology.h)
La structure KSJACK_DESCRIPTION décrit une prise audio.
Syntaxe
typedef struct __MIDL___MIDL_itf_devicetopology_0000_0000_0009 {
DWORD ChannelMapping;
COLORREF Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Membres
ChannelMapping
Spécifie le mappage des deux canaux audio d’une prise stéréo aux positions du haut-parleur.
Dans Windows Vista, la valeur de ce membre est l’une des valeurs d’énumération EChannelMapping indiquées dans le tableau suivant.
| Valeur | Premier canal | Deuxième canal |
|---|---|---|
| ePcxChanMap_FL_FR | Haut-parleur avant gauche | Haut-parleur avant droit |
| ePcxChanMap_FC_LFE | Haut-parleur frontal | Haut-parleur à effets basse fréquence (subwoofer) |
| ePcxChanMap_BL_BR | Haut-parleur arrière gauche | Haut-parleurs arrière droit |
| ePcxChanMap_FLC_FRC | Haut-parleur avant-centre gauche | Haut-parleur avant-centre droit |
| ePcxChanMap_SL_SR | Haut-parleur latéral gauche | Haut-parleur de côté droit |
| ePcxChanMap_Unknown | Unknown | Unknown |
Dans Windows 7, l’énumération EChannelMapping a été déconseillée. Le type de données de ce membre est un DWORD. Ce membre stocke 0 ou la combinaison de bits-OR d’une ou plusieurs des valeurs suivantes définies dans Ksmedia.h.
#define SPEAKER_FRONT_LEFT 0x1
#define SPEAKER_FRONT_RIGHT 0x2
#define SPEAKER_FRONT_CENTER 0x4
#define SPEAKER_LOW_FREQUENCY 0x8
#define SPEAKER_BACK_LEFT 0x10
#define SPEAKER_BACK_RIGHT 0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER 0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER 0x80
#define SPEAKER_BACK_CENTER 0x100
#define SPEAKER_SIDE_LEFT 0x200
#define SPEAKER_SIDE_RIGHT 0x400
#define SPEAKER_TOP_CENTER 0x800
#define SPEAKER_TOP_FRONT_LEFT 0x1000
#define SPEAKER_TOP_FRONT_CENTER 0x2000
#define SPEAKER_TOP_FRONT_RIGHT 0x4000
#define SPEAKER_TOP_BACK_LEFT 0x8000
#define SPEAKER_TOP_BACK_CENTER 0x10000
#define SPEAKER_TOP_BACK_RIGHT 0x20000
Color
Couleur du jack. La couleur est exprimée sous la forme d’une valeur RVB 32 bits qui est 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 de la prise est inconnue ou si le connecteur physique n’a pas de couleur identifiable, la valeur de ce membre est 0x00000000, c’est-à-dire noir.
ConnectionType
Type de la connexion. 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 |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
Jack 1/8 pouces |
| 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 de modem RJ11 |
| eConnTypeCombination | Combinaison de types de connecteurs |
GeoLocation
Emplacement géométrique de la prise. 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 | Panneau monté à l’arrière |
| eGeoLocFront | Panneau monté à l’avant |
| eGeoLocLeft | Panneau monté à gauche |
| eGeoLocRight | Panneau monté à droite |
| eGeoLocTop | Panneau monté par le haut |
| eGeoLocBottom | Panneau monté en bas |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
Volet arrière à ouverture coulissante 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 |
GenLocation
Emplacement général de la prise. 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 | Intérieur du châssis principal |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
Sur un châssis distinct |
| eGenLocOther | Autre emplacement |
PortConnection
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
Si l’adaptateur audio prend en charge la détection de présence de prise sur la prise, la valeur IsConnected indique si un périphérique de point de terminaison est branché sur la prise. Si IsConnected a la valeur TRUE, un appareil est branché. S’il a la valeur FALSE, la prise est vide. Pour les appareils qui ne prennent pas en charge la détection de présence de prise, ce membre est toujours TRUE. Pour plus d’informations sur la détection de présence jack, consultez Périphériques de point de terminaison audio.
Remarques
Cette structure est utilisée par la méthode IKsJackDescription ::GetJackDescription dans l’API DeviceTopology. 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | devicetopology.h |