Interface IKsJackDescription2 (devicetopology.h)

A interface IKsJackDescription2 fornece informações sobre as tomadas ou conectores internos que fornecem uma conexão física entre um dispositivo em um adaptador de áudio e um dispositivo de ponto de extremidade externo ou interno (por exemplo, um microfone ou player de CD).

Além de obter informações de tomada, como tipo de conexão, o IKsJackDescription é usado principalmente para relatar se a tomada estava conectada ao dispositivo. No Windows 7, se o driver de dispositivo conectado der suporte a IKsJackDescription2, a pilha de áudio ou um aplicativo poderá usar essa interface para obter informações adicionais de entrada. Isso inclui a capacidade de detecção do jack e se o formato do dispositivo foi alterado dinamicamente.

A maioria dos drivers de adaptador de áudio do Windows dá suporte ao WDM (Modelo de Driver do Windows) e usa propriedades de KS (streaming de kernel) para representar os parâmetros de descrição de hardware em conectores (conhecidos como pinos KS). A interface IKsJackDescription2 fornece acesso conveniente à propriedade KSPROPERTY_JACK_DESCRIPTION2 de um conector para um dispositivo de ponto de extremidade. Para obter mais informações sobre propriedades KS e pinos KS, consulte a documentação do DDK do Windows.

Um aplicativo obtém uma referência à interface IKsJackDescription2 de uma parte chamando o método IPart::Activate com refiid de parâmetro definido como REFIIDIID_IKsJackDescription2. A chamada para IPart::Activate só terá êxito se a parte der suporte à interface IKsJackDescription2 . Somente um objeto de parte que representa um conector de pino de ponte em um objeto de topologia de dispositivo de filtro KS dá suporte a essa interface.

Para obter um exemplo de código, consulte IKsJackDescription.

Herança

A interface IKsJackDescription2 herda da interface IUnknown . IKsJackDescription2 também tem estes tipos de membros:

Métodos

A interface IKsJackDescription2 tem esses métodos.

IKsJackDescription2::GetJackCount O método GetJackCount obtém o número de tomadas no conector, que são necessários para se conectar a um dispositivo de ponto de extremidade.
IKsJackDescription2::GetJackDescription2 O método GetJackDescription2 obtém a descrição de uma tomada de áudio especificada.

Requisitos

Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	devicetopology.h

Confira também

Principais interfaces de áudio

DeviceTopology API

IPart::Activate