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

No Windows Vista e posterior, a propriedade KSPROPERTY_JACK_DESCRIPTION fornece informações sobre um jack ou uma coleção de jacks em um subdispositivo em um adaptador de áudio. (Nesse contexto, o termo subdevice é 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 a localização física de um jack. Além disso, a estrutura contém um membro IsConnected que é TRUE se um dispositivo de áudio, como um microfone ou fones de ouvido, estiver conectado à tomada e FALSE se a tomada estiver vazia. Para fornecer um valor de estado up-topara IsConnected, o driver do adaptador para um subdispositivo dinâmico depende dos recursos de detecção de presença do conector do hardware de áudio. Para um subdevice estático (sem detecção de presença de jack), o membro IsConnected sempre deve ser TRUE. Para obter mais informações, consulte Jack Description Property.

Quando o usuário insere um plugue 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 plug do conector no subdispositivo dinâmico, o driver do adaptador deve chamar o método IUnregisterSubdevice::UnregisterSubdevice para excluir o registro do subdispositivo. Embora o subdevice não esteja registrado, se o driver do adaptador receber um IOCTL que contém uma solicitação KSPROPERTY_JACK_DESCRIPTION para o subdevice, o driver deverá definir o membro IsConnected do valor da propriedade como FALSE.