estrutura KSJACK_DESCRIPTION

Artigo
06/14/2023

A estrutura KSJACK_DESCRIPTION especifica os atributos físicos de uma tomada de áudio.

Sintaxe

typedef struct {
  DWORD              ChannelMapping;
  DWORD              Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

Membros

ChannelMapping
Especifica o mapeamento dos canais de áudio para as posições correspondentes do locutor. ChannelMapping é uma máscara de bits dos sinalizadores KSAUDIO_SPEAKER_XXX (por exemplo, SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT), que são definidos no arquivo de cabeçalho Ksmedia.h. ChannelMapping deve ser diferente de zero apenas para pinos de renderização analógicos. Para pinos de captura ou para pinos de renderização digital, defina esse membro como 0.

Observação

Devicetopology.h definiu originalmente ChannelMapping como uma enumeração do tipo EChannelMapping. Desde então, a enumeração EChannelMapping foi preterida e não é mais usada no Windows Vista e em versões posteriores dos sistemas operacionais Windows.

Cor
Especifica a cor da tomada. A cor é expressa como um valor RGB de 32 bits formado pela concatenação dos componentes de cor 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 representa preto.

ConnectionType
Especifica o tipo de conexão física para essa tomada. O valor desse membro é um dos valores de enumeração EPcxConnectionType mostrados na tabela a seguir.

Valor	Tipo de conector
eConnTypeUnknown	Unknown
eConnType3Point5mm	Minijack de 3,5 mm
eConnTypeQuarter	Tomada de 1/4 polegadas
eConnTypeAtapiInternal	Conector interno da ATAPI
eConnTypeRCA	Tomada 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 modem RJ11
eConnTypeCombination	Combinação de conector

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

Valor	Localização geométrica
eGeoLocRear	Traseiro
eGeoLocFront	Front
eGeoLocLeft	Esquerda
eGeoLocRight	Direita
eGeoLocTop	Parte superior
eGeoLocBottom	Menor
eGeoLocRearPanel	Painel aberto ou aberto por pull traseiro
eGeoLocRiser	Riser cartão
eGeoLocInsideMobileLid	Tampa interna do computador móvel
eGeoLocDrivebay	Drive Bay
eGeoLocHDMI	Conector HDMI
eGeoLocOutsideMobileLid	Tampa externa do computador móvel
eGeoLocATAPI	Conector da ATAPI
eGeoLocNotApplicable	Não aplicável. Consulte a seção Comentários .

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

Valor	Localização geral
eGenLocPrimaryBox	No chassi primário
eGenLocInternal	Dentro do chassi primário
eGenLocSeparate	Em chassis separados
eGenLocOther	Outro local

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

Valor	Tipo de conexão de porta
ePortConnJack	Jack
ePortConnIntegratedDevice	Slot para um dispositivo integrado
ePortConnBothIntegratedAndJack	Um conector e um slot para um dispositivo integrado
ePortConnUnknown	Unknown

Isconnected
Indica se há um dispositivo externo conectado à tomada. Se o controlador de áudio der suporte à detecção de tomada nesse pino, o valor de IsConnected deverá indicar com precisão se a tomada está ocupada por um plugue a qualquer momento. Esse valor sempre deve ser definido como TRUE para dispositivos que não dão suporte à detecção de tomadas.

Comentários

Essa estrutura é usada pela propriedade KSPROPERTY_JACK_DESCRIPTION no Windows Vista e posterior. 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.

Quando um dispositivo de áudio não expõe uma tomada fisicamente acessível, o dispositivo de áudio usa o valor eGeoLocNotApplicable para indicar aos aplicativos baseados no Windows e no Windows que não há entrada física. Dessa forma, também não há nenhum local geométrico. Por exemplo, o dispositivo de áudio pode ser integrado à placa-mãe, sem tomadas acessíveis.