estrutura KSJACK_DESCRIPTION (devicetopology.h)

A estrutura KSJACK_DESCRIPTION descreve uma tomada de áudio.

Sintaxe

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;

Membros

ChannelMapping

Especifica o mapeamento dos dois canais de áudio em uma tomada estéreo para as posições do alto-falante.

No Windows Vista, o valor desse membro é um dos valores de enumeração EChannelMapping mostrados na tabela a seguir.

No Windows 7, a enumeração EChannelMapping foi preterida. O tipo de dados desse membro é um DWORD. Esse membro armazena 0 ou a combinação OR bit a bit de um ou mais dos valores a seguir definidos em 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

A cor da tomada. A cor é expressa como um valor RGB de 32 bits formado pela concatenação dos componentes de cores azul, verde e vermelho de 8 bits. O componente azul ocupa os 8 bits menos significativos (bits 0-7), o componente verde ocupa os bits 8-15 e o componente vermelho ocupa os bits 16-23. Os 8 bits mais significativos são zeros. Se a cor da tomada for desconhecida ou o conector físico não tiver nenhuma cor identificável, o valor desse membro será 0x00000000, que é preto.

ConnectionType

O tipo de conexão. O valor desse membro é um dos valores de enumeração EPcxConnectionType mostrados na tabela a seguir.

GeoLocation

O local geométrico da tomada. O valor desse membro é um dos valores de enumeração EPcxGeoLocation mostrados na tabela a seguir.

GenLocation

A localização geral da tomada. O valor desse membro é um dos valores de enumeração EPcxGenLocation mostrados na tabela a seguir.

PortConnection

O tipo de porta representada pela tomada. O valor desse membro é um dos valores de enumeração EPxcPortConnection mostrados na tabela a seguir.

IsConnected

Se o adaptador de áudio der suporte à detecção de presença de tomada na tomada, o valor de IsConnected indicará se um dispositivo de ponto de extremidade está conectado à tomada. Se IsConnected for TRUE, um dispositivo será conectado. Se for FALSE, a tomada estará vazia. Para dispositivos que não dão suporte à detecção de presença de jack, esse membro é sempre TRUE. Para obter mais informações sobre a detecção de presença de jack, consulte Dispositivos de ponto de extremidade de áudio.

Comentários

Essa estrutura é usada pelo método IKsJackDescription::GetJackDescription na API DeviceTopology. Ele descreve uma tomada de áudio que faz parte de uma conexão entre um dispositivo de ponto de extremidade e um dispositivo de hardware em um adaptador de áudio. Quando um usuário precisa conectar um dispositivo de ponto de extremidade a uma tomada ou desconectá-lo de uma tomada, um aplicativo de áudio pode usar as informações descritivas na estrutura para ajudar o usuário a encontrar a tomada.

Requisitos

Confira também

Estruturas de áudio principais

IKsJackDescription::GetJackDescription