Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
No Windows Vista, o sistema gera cadeias de caracteres de ID de ponto de extremidade para identificar os dispositivos de ponto de extremidade de áudio no sistema. Uma string de ID de ponto de extremidade é uma string de caracteres largos terminada por um nulo. A cadeia de ID de ponto de extremidade para um dispositivo de áudio específico identifica exclusivamente o dispositivo entre todos os dispositivos de áudio no sistema.
Se um sistema contiver dois ou mais dispositivos de adaptador de áudio idênticos, os dispositivos de ponto de extremidade de áudio correspondentes terão nomes amigáveis idênticos, mas cada dispositivo de ponto de extremidade terá uma cadeia de caracteres de ID de ponto de extremidade exclusiva. Para obter mais informações sobre como obter o nome amigável de um dispositivo endpoint, consulte Propriedades do dispositivo.
Depois de obter uma instância de interfaceIMMDevicepara um dispositivo de ponto de extremidade de áudio, um cliente pode chamar o métodoIMMDevice::GetIdpara obter a cadeia de caracteres de ID de ponto de extremidade para o dispositivo. Um cliente pode usar a cadeia de caracteres de ID de ponto de extremidade para criar uma instância do dispositivo de ponto de extremidade de áudio mais tarde ou em um processo diferente, chamando o método IMMDeviceEnumerator::GetDevice.
Um cliente pode organizar o recebimento de uma notificação quando o status de qualquer dispositivo de ponto de extremidade de áudio mudar. Para receber notificações, o cliente implementa uma interface IMMNotificationClient e regista essa interface com a API MMDevice. Quando o estado de um dispositivo de ponto de extremidade muda, a API MMDevice chama o método apropriado na interface do cliente EDataFlow. Um dos parâmetros de entrada para o método é a cadeia de caracteres de ID do ponto de extremidade que identifica o dispositivo de ponto de extremidade cujo status foi alterado. Para obter mais informações sobre EDataFlow, consulte Device Events.
APIs de áudio herdadas, como DirectSound e as funções multimídia do Windows, têm suas próprias interfaces para enumerar e identificar dispositivos de áudio. No Windows Vista, essas interfaces foram estendidas para fornecer as cadeias de caracteres de ID de ponto de extremidade que identificam os dispositivos de ponto de extremidade subjacentes às abstrações de dispositivos apresentadas pelas APIs.
Durante a enumeração do dispositivo DirectSound, o DirectSound fornece a cadeia de caracteres de ID do ponto de extremidade para cada dispositivo que enumera. Para obter mais informações, consulte Eventos de Áudio para Aplicações de Áudio Legadas.
Para obter a cadeia de caracteres de ID do ponto de extremidade para um dispositivo de forma de onda herdado, use a função waveOutMessage ou a função waveInMessage para enviar uma mensagem DRV_QUERYFUNCTIONINSTANCEID para o driver de dispositivo de forma de onda. Para obter um exemplo de código que mostra o uso dessa mensagem, consulte funções de dispositivo para aplicativos multimídia herdados do Windows.
Para obter mais informações sobre como usar os recursos das APIs de áudio principais para aprimorar aplicativos que usam APIs de áudio herdadas, consulte Interoperabilidade com APIs de áudio herdadas.
Os clientes devem tratar o conteúdo da string de ID do ponto de extremidade como opaco. Ou seja, os clientes não devem tentar analisar o conteúdo da cadeia de caracteres para obter informações sobre o dispositivo. O motivo é que o formato da cadeia de caracteres é indefinido e pode mudar de uma implementação do módulo do sistema da API MMDevice para a próxima.
O tempo de vida de uma cadeia de caracteres de ID de ponto de extremidade está vinculado à instalação do dispositivo. A cadeia de caracteres de ID de ponto de extremidade de um dispositivo será alterada se o usuário atualizar o driver de dispositivo ou se o usuário desinstalar o dispositivo e instalá-lo novamente. No entanto, a cadeia de caracteres de ID do ponto de extremidade permanece inalterada durante as reinicializações do sistema, e a cadeia de caracteres de ID do ponto de extremidade de um dispositivo de áudio USB permanece inalterada se o usuário desconectar o dispositivo e conectá-lo novamente.
Tópicos relacionados