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 |