estrutura KSJACK_DESCRIPTION
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.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |