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.

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.

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.

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.

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.

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

Consulte también

Estructuras de audio principales

IKsJackDescription::GetJackDescription