estructura de KSJACK_DESCRIPTION
La estructura KSJACK_DESCRIPTION especifica los atributos físicos de una toma de audio.
Sintaxis
typedef struct {
DWORD ChannelMapping;
DWORD Color;
EPcxConnectionType ConnectionType;
EPcxGeoLocation GeoLocation;
EPcxGenLocation GenLocation;
EPxcPortConnection PortConnection;
BOOL IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;
Miembros
ChannelMapping
Especifica la asignación de los canales de audio a las posiciones del altavoz correspondientes. ChannelMapping es una máscara de bits de las marcas KSAUDIO_SPEAKER_XXX (por ejemplo, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), que se definen en el archivo de encabezado Ksmedia.h. ChannelMapping solo debe ser distinto de cero para los pines de representación analógica. Para pins de captura o para patillas de representación digital, establezca este miembro en 0.
Nota
Devicetopology.h definió originalmente ChannelMapping como una enumeración de tipo EChannelMapping. La enumeración EChannelMapping ha quedado en desuso y ya no se usa en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Color
Especifica el color del conector. 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 representa el negro.
ConnectionType
Especifica el tipo de conexión física para este conector. 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 |
eConnType3Point5mm |
Minijack de 3,5 mm |
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 conectores |
Geolocalización
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 |
Rear |
eGeoLocFront |
Front |
eGeoLocLeft |
Left |
eGeoLocRight |
Right |
eGeoLocTop |
Superior |
eGeoLocBottom |
Inferior |
eGeoLocRearPanel |
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 |
eGeoLocNotApplicable |
No es aplicable. Consulte la sección Comentarios . |
GenLocation
Especifica la ubicación general del conector. 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 |
eGenLocSeparate |
En chasis independiente |
eGenLocOther |
Otra ubicación |
PortConnection
Especifica el 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
Indica si hay un dispositivo externo conectado al conector. Si el controlador de audio admite la detección de tomas en este pin, el valor de IsConnected debe indicar con precisión si el conector está ocupado por un enchufe en un momento dado. Este valor siempre debe establecerse en TRUE para los dispositivos que no admiten la detección de tomas.
Comentarios
Esta estructura la usa la propiedad KSPROPERTY_JACK_DESCRIPTION en Windows Vista y versiones posteriores. 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.
Cuando un dispositivo de audio no expone un conector accesible físicamente, el dispositivo de audio usa el valor eGeoLocNotApplicable para indicar a las aplicaciones basadas en Windows y Windows que no hay ningún conector físico. Por lo tanto, tampoco hay ninguna ubicación geométrica. Por ejemplo, el dispositivo de audio se puede integrar en la placa base, sin ningún conector accesible.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |