estructura de KSJACK_DESCRIPTION (devicetopology.h)
La estructura KSJACK_DESCRIPTION describe un conector de audio.
Sintaxis
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;
Miembros
ChannelMapping
Especifica la asignación de los dos canales de audio en una toma estéreo a las posiciones del altavoz.
En Windows Vista, el valor de este miembro es uno de los valores de enumeración EChannelMapping que se muestran en la tabla siguiente.
| Valor | Primer canal | Segundo canal |
|---|---|---|
| ePcxChanMap_FL_FR | Altavoz front-left | Altavoz frontal derecho |
| ePcxChanMap_FC_LFE | Altavoz front-center | Altavoz de efectos de baja frecuencia (subwoofer) |
| ePcxChanMap_BL_BR | Altavoz back-left | Altavoces de atrás a la derecha |
| ePcxChanMap_FLC_FRC | Altavoz frontal izquierdo-central | Altavoz front-right-center |
| ePcxChanMap_SL_SR | Altavoz lateral izquierdo | Altavoz lateral derecho |
| ePcxChanMap_Unknown | Desconocido | Desconocido |
En Windows 7, la enumeración EChannelMapping ha quedado en desuso . El tipo de datos de este miembro es un DWORD. Este miembro almacena 0 o la combinación or bit a bit de uno o varios de los siguientes valores definidos en 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
El color de la toma. El color se expresa como un valor RGB de 32 bits formado por concatenar los componentes de color azul, verde y rojo de 8 bits. El componente azul ocupa los 8 bits menos significativos (bits 0-7), el componente verde ocupa los bits 8-15 y el componente rojo ocupa los bits 16-23. Los 8 bits más significativos son ceros. Si el color de la toma es desconocido o el conector físico no tiene ningún color identificable, el valor de este miembro es 0x00000000, que es negro.
ConnectionType
Tipo de conexión. El valor de este miembro es uno de los valores de enumeración EPcxConnectionType que se muestran en la tabla siguiente.
| Valor | Tipo de conector |
|---|---|
| eConnTypeUnknown | Desconocido |
|
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7) |
Conector de 1/8 pulgadas |
| eConnTypeQuarter | Conector de 1/4 pulgadas |
| eConnTypeAtapiInternal | Conector interno de ATAPI |
| eConnTypeRCA | Conector RCA |
| eConnTypeOptical | Conector óptico |
| eConnTypeOtherDigital | Conector digital genérico |
| eConnTypeOtherAnalog | Conector analógico genérico |
| eConnTypeMultichannelAnalogDIN | Conector DIN analógico multicanal |
| eConnTypeXlrProfessional | Conector XLR |
| eConnTypeRJ11Modem | Conector de módem RJ11 |
| eConnTypeCombination | Combinación de tipos de conectores |
GeoLocation
Ubicación geométrica del jack. El valor de este miembro es uno de los valores de enumeración EPcxGeoLocation que se muestran en la tabla siguiente.
| Valor | Ubicación geométrica |
|---|---|
| eGeoLocRear | Panel montado en la parte posterior |
| eGeoLocFront | Panel montado delante |
| eGeoLocLeft | Panel montado a la izquierda |
| eGeoLocRight | Panel montado a la derecha |
| eGeoLocTop | Panel montado en la parte superior |
| eGeoLocBottom | Panel montado en la parte inferior |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
Panel de apertura de diapositivas posteriores o de extracción |
| eGeoLocRiser | Tarjeta Riser |
| eGeoLocInsideMobileLid | Tapa interior del equipo móvil |
| eGeoLocDrivebay | Bahía de unidad |
| eGeoLocHDMI | Conector HDMI |
| eGeoLocOutsideMobileLid | Tapa externa del equipo móvil |
| eGeoLocATAPI | Conector ATAPI |
GenLocation
La ubicación general del jack. El valor de este miembro es uno de los valores de enumeración EPcxGenLocation que se muestran en la tabla siguiente.
| Valor | Ubicación general |
|---|---|
| eGenLocPrimaryBox | En el chasis principal |
| eGenLocInternal | Dentro del chasis principal |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
En chasis independiente |
| eGenLocOther | Otra ubicación |
PortConnection
Tipo de puerto representado por el conector. El valor de este miembro es uno de los valores de enumeración EPxcPortConnection que se muestran en la tabla siguiente.
| Valor | Tipo de conexión de puerto |
|---|---|
| ePortConnJack | Jack |
| ePortConnIntegratedDevice | Ranura para un dispositivo integrado |
| ePortConnBothIntegratedAndJack | Tanto un conector como una ranura para un dispositivo integrado |
| ePortConnUnknown | Desconocido |
IsConnected
Si el adaptador de audio admite la detección de presencia de jack en el conector, el valor de IsConnected indica si un dispositivo de punto de conexión está conectado al conector. Si IsConnected es TRUE, se conecta un dispositivo. Si es FALSE, el jack está vacío. En el caso de los dispositivos que no admiten la detección de presencia de jack, este miembro siempre es TRUE. Para obtener más información sobre la detección de presencia de jack, consulte Dispositivos de punto de conexión de audio.
Comentarios
Esta estructura la usa el método IKsJackDescription::GetJackDescription en la API DeviceTopology. Describe un conector de audio que forma parte de una conexión entre un dispositivo de punto de conexión y un dispositivo de hardware en un adaptador de audio. Cuando un usuario necesita conectar un dispositivo de punto de conexión a un conector o desconectarlo de un conector, una aplicación de audio puede usar la información descriptiva en la estructura para ayudar al usuario a encontrar el conector.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | devicetopology.h |