Eindpunt-ID-tekenreeksen
In Windows Vista genereert het systeem eindpunt-id-tekenreeksen om de audio-eindpuntapparaten te identificeren in het systeem. Een eindpunt-id-tekenreeks is een null-beëindigde tekenreeks. De eindpunt-id-tekenreeks voor een bepaald audio-eindpuntapparaat identificeert het apparaat uniek tussen alle audio-eindpuntapparaten in het systeem.
Als een systeem twee of meer identieke audioadapterapparaten bevat, hebben de bijbehorende audio-eindpuntapparaten identieke namen, maar elk eindpuntapparaat heeft een unieke eindpunt-id-tekenreeks. Zie Apparaateigenschappenvoor meer informatie over het verkrijgen van de gebruiksvriendelijke naam van een eindpuntapparaat.
Nadat een IMMDevice interface-exemplaar voor een audio-eindpuntapparaat is verkregen, kan een client de methode IMMDevice::GetId aanroepen om de eindpunt-id-tekenreeks voor het apparaat te verkrijgen. Een client kan de eindpunt-id-tekenreeks gebruiken om op een later tijdstip of in een ander proces een exemplaar van het audio-eindpuntapparaat te maken door de methode IMMDeviceEnumerator::GetDevice aan te roepen.
Een client kan een melding ontvangen wanneer de status van een audio-eindpuntapparaat wordt gewijzigd. Voor het ontvangen van meldingen implementeert de client een IMMNotificationClient interface en registreert deze interface met de MMDevice-API. Wanneer de status van een eindpuntapparaat wordt gewijzigd, roept de MMDevice-API de juiste methode aan in de EDataFlow-interface van de client. Een van de invoerparameters voor de methode is de eindpunt-id-tekenreeks die het eindpuntapparaat identificeert waarvan de status is gewijzigd. Zie Device Eventsvoor meer informatie over EDataFlow-.
Verouderde audio-API's, zoals DirectSound en de Windows-multimediafuncties, hebben hun eigen interfaces voor het inventariseren en identificeren van audioapparaten. In Windows Vista zijn deze interfaces uitgebreid om de eindpunt-id-tekenreeksen op te geven die de eindpuntapparaten identificeren die ten grondslag liggen aan de apparaatabstracties gepresenteerd door de API's.
Tijdens de opsomming van DirectSound-apparaten levert DirectSound de eindpunt-id-tekenreeks voor elk apparaat dat wordt opgesomd. Zie Audio-gebeurtenissen voor verouderde audiotoepassingenvoor meer informatie.
Gebruik de waveOutMessage-- of waveInMessage--functie om een DRV_QUERYFUNCTIONINSTANCEID-bericht naar het waveform-apparaatstuurprogramma te verzenden, om de eindpunt-id-tekenreeks voor een verouderd waveform-apparaat te verkrijgen. Zie Apparaatrollen voor oudere Windows Multimedia-toepassingenvoor een codevoorbeeld waarin het gebruik van dit bericht wordt weergegeven.
Zie Interoperability with Legacy Audio API'svoor meer informatie over het gebruik van de mogelijkheden van de kernaudio-API's om toepassingen te verbeteren die gebruikmaken van verouderde audio-API's.
Clients moeten de inhoud van de eindpunt-id-tekenreeks behandelen als ondoorzichtig. Dat wil zeggen, klanten mogen niet proberen de inhoud van de tekenreeks te analyseren om informatie over het apparaat te verkrijgen. De reden hiervoor is dat de tekenreeksindeling niet is gedefinieerd en kan veranderen van de ene implementatie van de MMDevice API-systeemmodule naar de volgende.
De levensduur van een eindpunt-id-tekenreeks is gekoppeld aan de installatie van het apparaat. De eindpunt-id-tekenreeks van een apparaat wordt gewijzigd als de gebruiker het apparaatstuurprogramma bijwerken of als de gebruiker het apparaat verwijdert en het opnieuw installeert. De eindpunt-id-tekenreeks blijft echter ongewijzigd tijdens het opnieuw opstarten van het systeem en de eindpunt-id-tekenreeks van een USB-audioapparaat blijft ongewijzigd als de gebruiker het apparaat loskoppelt en het weer aansluit.
Verwante onderwerpen