KSPROPERTY_JACK_DESCRIPTION3

A propriedade KSPROPERTY_JACK_DESCRIPTION3 é implementada como uma propriedade pin-wise que é acessada usando o identificador de filtro.

Na versão 22H2 e posteriores dos sistemas operacionais Windows, a estrutura de KSJACK_DESCRIPTION3 associada pode ser usada para especificar e alterar a configuração atual da tomada.

Tabela de Resumo de Uso do

O valor da propriedade (dados da instância) é um KSMULTIPLE_ITEM, seguido por uma matriz de estruturas de KSJACK_DESCRIPTION3.

valor retornado

Uma solicitação de propriedade KSPROPERTY_JACK_DESCRIPTION3 retorna um KSMULTIPLE_ITEM seguido por uma matriz de N KSJACK_DESCRIPTION3 estruturas, em que N = o número de tomadas associadas ao pino de ponte especificado. A lista a seguir mostra os itens retornados pela solicitação de propriedade.

KSMULTIPLE_ITEM. Size = sizeof(KSMULTIPLE_ITEM) + N * sizeof(KSJACK_DESCRIPTION3)

KSMULTIPLE_ITEM. Contagem = N

KSJACK_DESCRIPTION3[0]

...

KSJACK_DESCRIPTION3[N-1]

Observações

Comunicando alterações no dispositivo de áudio usando KSJACK_DESCRIPTION3 e KSPROPERTY_JACK_DESCRIPTION3

O sistema de áudio do Windows armazena em cache os recursos do dispositivo de áudio durante a criação do ponto de extremidade de áudio. Esses valores armazenados em cache são para recursos como a presença de um mecanismo de áudio HW, suporte de formato, ID do contêiner, características de tamanho do buffer etc. Esses valores armazenados em cache são mantidos durante a vida útil da instalação do Windows. Eles são atualizados somente quando o driver de áudio é atualizado ou durante uma atualização do sistema operacional.

Com KSJACK_DESCRIPTION3, o sistema de áudio do Windows fornece um mecanismo para o driver de áudio solicitar que todos os valores armazenados em cache sejam descartados e atualizados. A solicitação pode ser disparada por alterações nos recursos do dispositivo de áudio, como restrições de recurso.

Sempre que o driver alterar o conteúdo de KSJACK_DESCRIPTION3 em runtime, o driver disparará o evento de KSEVENT_PINCAPS_JACKINFOCHANGE existente.

O sistema de áudio do Windows mantém o último valor ConfigId relatado armazenado em cache no ponto de extremidade de áudio. O valor ConfigId é recuperado em resposta a KSEVENT_PINCAPS_JACKINFOCHANGE evento e durante o processamento normal do ponto de extremidade de áudio na inicialização do sistema, reinicialização do serviço Do Construtor de Ponto de Extremidade de Áudio, atualização do driver de áudio ou alterações de estado da interface para o ponto de extremidade.

Se o valor de ConfigId recuperado for diferente do valor armazenado anteriormente, o sistema de áudio do Windows descartará todos os recursos de ponto de extremidade armazenados anteriormente e os atualizará.

O uso recomendado é definir várias configurações de ponto de extremidade de áudio dentro do driver controlado pelo valor de ConfigId (bitmask ou enum). Por exemplo, ConfigId de 1 pode indicar a presença de um nó do mecanismo de áudio, enquanto ConfigId 2 não relataria um nó do mecanismo de áudio. A ConfigId em uso pelo driver é compartilhada com o sistema de áudio do Windows por meio de KSPROPERTY_JACK_DESCRIPTION3 e atua para sincronizar o ponto de extremidade com os recursos armazenados em cache pelo sistema de áudio do Windows.

O valor da ConfigId é opaco para o Windows. O driver de áudio pode usar um carimbo de data/hora ou um valor de incremento escolhido em tempo de execução no lugar de uma máscara de bits ou enumeração, conforme sugerido acima. Essa estratégia não é recomendada, pois pode resultar em atualizações desnecessárias de ponto de extremidade durante a inicialização ou alterações na interface para sincronizar o último valor ConfigId armazenado com o valor recentemente relatado, mesmo quando os recursos do ponto de extremidade não forem alterados. Essa abordagem também pode aumentar as chances de o driver e o Windows ficarem fora de sincronia, o que pode resultar em falhas de reprodução de áudio.

O mecanismo usado para atualizar os valores armazenados em cache no ponto de extremidade quando o ConfigId é alterado é o mesmo usado para atualizações do sistema operacional e atualizações de driver. Um novo ponto de extremidade com uma ID diferente é criado, que conterá os valores armazenados em cache atualizados que correspondem às novas configurações de ConfigId para o ponto de extremidade, as configurações do usuário são copiadas do ponto de extremidade antigo para o novo ponto de extremidade e, por fim, o ponto de extremidade antigo é excluído. Para obter mais informações, sobre o processo de migração de ponto de extremidade de áudio em atualizações do sistema operacional, consulte Atualizações do Sistema Operacional.

Requisitos

Consulte também

KSJACK_DESCRIPTION3

KSMULTIPLE_ITEM

Atualizações do sistema operacional