Compartilhar via

estrutura ACX_JACK_DESCRIPTION (acxpin.h)

  • Artigo

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