estrutura ACX_JACK_DESCRIPTION (acxpin.h)

A estrutura ACX_JACK_DESCRIPTION descreve atributos de uma tomada de áudio, como tipo de conexão, local físico e assim por diante.

Sintaxe

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

Membros

ChannelMapping

Especifica o mapeamento dos canais de áudio para as posições correspondentes do alto-falante. ChannelMapping é uma máscara de bits dos sinalizadores de 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.

Color

Especifica 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 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 conectores

GeoLocation

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 de abertura de slides ou abertura de 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 de 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 representado 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

Comentários

Essa estrutura 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 windows que não há nenhuma tomada 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.

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito	Valor
Cabeçalho	acxpin.h

Confira também

• cabeçalho acxpin.h