Compartilhar via


estrutura KSJACK_DESCRIPTION (devicetopology.h)

A estrutura KSJACK_DESCRIPTION descreve uma tomada de áudio.

Sintaxe

typedef struct __MIDL___MIDL_itf_devicetopology_0000_0000_0009 {
  DWORD              ChannelMapping;
  COLORREF           Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

Membros

ChannelMapping

Especifica o mapeamento dos dois canais de áudio em uma tomada estéreo para as posições do alto-falante.

No Windows Vista, o valor desse membro é um dos valores de enumeração EChannelMapping mostrados na tabela a seguir.

Valor Primeiro canal Segundo canal
ePcxChanMap_FL_FR Alto-falante frontal esquerdo Alto-falante frontal à direita
ePcxChanMap_FC_LFE Alto-falante do front-center Alto-falante de efeitos de baixa frequência (subwoofer)
ePcxChanMap_BL_BR Alto-falante back-left Alto-falantes à direita
ePcxChanMap_FLC_FRC Alto-falante front-left-center Alto-falante front-right-center
ePcxChanMap_SL_SR Alto-falante lateral esquerdo Alto-falante lateral direito
ePcxChanMap_Unknown Unknown Unknown
 

Para um conector físico com um, três ou mais canais, o valor desse membro é ePcxChanMap_Unknown.

No Windows 7, a enumeração EChannelMapping foi preterida. O tipo de dados desse membro é um DWORD. Esse membro armazena 0 ou a combinação OR bit a bit de um ou mais dos valores a seguir definidos em Ksmedia.h.

#define SPEAKER_FRONT_LEFT              0x1
#define SPEAKER_FRONT_RIGHT             0x2
#define SPEAKER_FRONT_CENTER            0x4
#define SPEAKER_LOW_FREQUENCY           0x8
#define SPEAKER_BACK_LEFT               0x10
#define SPEAKER_BACK_RIGHT              0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER    0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER   0x80
#define SPEAKER_BACK_CENTER             0x100
#define SPEAKER_SIDE_LEFT               0x200
#define SPEAKER_SIDE_RIGHT              0x400
#define SPEAKER_TOP_CENTER              0x800
#define SPEAKER_TOP_FRONT_LEFT          0x1000
#define SPEAKER_TOP_FRONT_CENTER        0x2000
#define SPEAKER_TOP_FRONT_RIGHT         0x4000
#define SPEAKER_TOP_BACK_LEFT           0x8000
#define SPEAKER_TOP_BACK_CENTER         0x10000
#define SPEAKER_TOP_BACK_RIGHT          0x20000

Color

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 é preto.

ConnectionType

O tipo de conexão. O valor desse membro é um dos valores de enumeração EPcxConnectionType mostrados na tabela a seguir.

Valor Tipo de conector
eConnTypeUnknown Unknown
eConnTypeEighth (Windows Vista)

eConnType3Point5mm

(Windows 7)
Tomada de 1/8 polegadas
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 tipos de conector

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 Painel montado na parte traseira
eGeoLocFront Painel montado na frente
eGeoLocLeft Painel montado à esquerda
eGeoLocRight Painel montado à direita
eGeoLocTop Painel montado na parte superior
eGeoLocBottom Painel montado na parte inferior
eGeoLocRearOPanel(Windows Vista)

eGeoLocRearPanel(Windows 7)

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

GenLocation

A localização 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
eGenLocSeperate(Windows Vista)

eGenLocSeparate(Windows 7)

Em chassis separados
eGenLocOther Outro local

PortConnection

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 Uma tomada e um slot para um dispositivo integrado
ePortConnUnknown Unknown

IsConnected

Se o adaptador de áudio der suporte à detecção de presença de tomada na tomada, o valor de IsConnected indicará se um dispositivo de ponto de extremidade está conectado à tomada. Se IsConnected for TRUE, um dispositivo será conectado. Se for FALSE, a tomada estará vazia. Para dispositivos que não dão suporte à detecção de presença de jack, esse membro é sempre TRUE. Para obter mais informações sobre a detecção de presença de jack, consulte Dispositivos de ponto de extremidade de áudio.

Comentários

Essa estrutura é usada pelo método IKsJackDescription::GetJackDescription na API DeviceTopology. 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho devicetopology.h

Confira também

Estruturas de áudio principais

IKsJackDescription::GetJackDescription