Compartilhar via


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)

Confira também

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3