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 de alto-falante correspondentes. 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 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 esse jack. O valor desse membro é um dos valores de enumeração EPcxConnectionType mostrados na tabela a seguir.
| Valor | Tipo de conector |
|---|---|
| eConnTypeUnknown | Desconhecido |
| eConnType3Point5mm | Minijack de 3,5 mm |
| eConnTypeQuarter | Jack de 1/4 polegadas |
| eConnTypeAtapiInternal | Conector interno da ATAPI |
| eConnTypeRCA | Jack 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 do valete. O valor desse membro é um dos valores de enumeração EPcxGeoLocation mostrados na tabela a seguir.
| Valor | Localização geométrica |
|---|---|
| eGeoLocRear | Traseira |
| eGeoLocFront | Frente |
| eGeoLocLeft | Esquerda |
| eGeoLocRight | Certo |
| eGeoLocTop | Início |
| eGeoLocBottom | Fundo |
| eGeoLocRearPanel | Painel aberto por slide traseiro ou pull-open |
| eGeoLocRiser | Cartão riser |
| eGeoLocInsideMobileLid | Tampa interna do computador móvel |
| eGeoLocDrivebay | Compartimento de unidade |
| 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 do jack. 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 pelo jack. O valor desse membro é um dos valores de enumeração EPxcPortConnection mostrados na tabela a seguir.
| Valor | Tipo de conexão de porta |
|---|---|
| ePortConnJack | Valete |
| ePortConnIntegratedDevice | Slot para um dispositivo integrado |
| ePortConnBothIntegratedAndJack | Uma tomada e um slot para um dispositivo integrado |
| ePortConnUnknown | Desconhecido |
Observações
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 desligá-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á nenhuma tomada física. Como tal, 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 versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxpin.h |