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 |
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 |