Descrições de jack para subdispositivos de áudio dinâmico

No Windows Vista e posteriores, a propriedade KSPROPERTY_JACK_DESCRIPTION fornece informações sobre uma tomada ou uma coleção de tomadas em um subdispositivo em um adaptador de áudio. (Nesse contexto, o termo subdispositivo é sinônimo de filtro KS.) O valor da propriedade é uma matriz de uma ou mais estruturas KSJACK_DESCRIPTION . Cada estrutura descreve a cor, o tipo de conector e o local físico de uma tomada. Além disso, a estrutura contém um membro IsConnected que será TRUE se um dispositivo de ponto de extremidade de áudio, como um microfone ou fones de ouvido, estiver conectado à tomada e for FALSE se a tomada estiver vazia. Para fornecer um valor atualizado para IsConnected, o driver do adaptador para um subdispositivo dinâmico depende dos recursos de detecção de presença de entrada do hardware de áudio. Para um subdispositivo estático (sem detecção de presença de tomada), o membro IsConnected sempre deve ser TRUE. Para obter mais informações, consulte Propriedade Jack Description.

Quando o usuário insere um plug-in em uma tomada em um subdispositivo dinâmico, o driver do adaptador deve chamar a função PcRegisterSubdevice para registrar o subdispositivo. Embora o subdispositivo permaneça registrado, se o driver do adaptador receber um IOCTL que contém uma solicitação KSPROPERTY_JACK_DESCRIPTION para o subdispositivo, o driver deverá definir o membro IsConnected do valor da propriedade como TRUE.

Quando o usuário remove o plugue da tomada no subdispositivo dinâmico, o driver do adaptador deve chamar o método IUnregisterSubdevice::UnregisterSubdevice para excluir o registro do subdispositivo. Embora o subdispositivo não esteja registrado, se o driver do adaptador receber um IOCTL que contém uma solicitação KSPROPERTY_JACK_DESCRIPTION para o subdispositivo, o driver deverá definir o membro IsConnected do valor da propriedade como FALSE.